Los nombres de función no distinguen mayúsculas (toUpper, toupper y
TOUPPER son la misma). Una función que no aparece aquí falla con
function name is not supported (HTTP 400, code: "unsupported").
Salvo que se indique lo contrario, un argumento NULL da un resultado
NULL.
Operadores
| Operador | Significado | Ejemplo → resultado |
|---|
+ | Suma números; concatena strings o listas | 1 + 2 → 3, 'a' + 1 → 'a1', [1] + [2] → [1, 2] |
-, * | Resta, multiplicación | 7 * 3 → 21 |
/ | División. Entero entre entero trunca hacia cero | 7 / 2 → 3, -7 / 2 → -3, 7.0 / 2 → 3.5 |
% | Resto (con el signo del dividendo) | 7 % -3 → 1 |
^ | Potencia, siempre un flotante | 2 ^ 10 → 1024.0 |
-x | Negación | -3 |
= <> | Igualdad. 1 = 1.0 es true; las listas y los mapas se comparan estructuralmente | [1,2] = [1,2] → true |
< > <= >= | Orden para números, strings, fechas y datetimes. Los tipos incompatibles dan NULL | 'abc' < 'abd' → true, 1 < 'a' → null |
AND OR XOR NOT | Lógica de tres valores | null AND false → false, null OR true → true |
IS NULL, IS NOT NULL | Prueba de null | null IS NULL → true |
IN | Pertenencia a una lista (consciente de NULL) | 1 IN [1, null] → true, 2 IN [1, null] → null |
STARTS WITH, ENDS WITH, CONTAINS | Pruebas de strings, distinguen mayúsculas | 'abc' CONTAINS 'b' → true |
=~ | Expresión regular, debe coincidir con el string completo. (?i) para no distinguir mayúsculas | 'Alice' =~ '(?i)al.*' → true |
x[i] | Índice de lista, negativo desde el final | [1,2,3][-1] → 3 |
x[a..b], x[..b], x[a..] | Slice de lista (final exclusivo) | [1,2,3,4][1..3] → [2, 3] |
m.key, n.prop | Acceso a clave de mapa o a propiedad | {a: 1}.a → 1 |
La aritmética entera es de 64 bits y da la vuelta al desbordarse
(9223372036854775807 + 1 → -9223372036854775808). La división de
flotantes entre cero da Infinity; la división entera entre cero es un
error.
Grafo e identidad
| Función | Retorna |
|---|
id(x) | El id de un nodo como string UUID; para una relación, "<src>:<dst>". |
elementId(x) | El id de un nodo (string UUID); para una relación, "<TYPE>-<src>-><dst>". |
labels(n) | Lista de labels del nodo, ordenada. |
type(r) | El tipo de la relación. |
keys(x) | Claves de propiedades de un nodo, una relación o un mapa. |
properties(x) | Mapa de propiedades de un nodo o una relación. |
nodes(p), relationships(p) | Los nodos / relaciones de un camino. |
length(p) | Cantidad de relaciones en un camino. |
n._id lee el id del nodo como una propiedad, y
MATCH (n:Label {_id: $id}) busca un nodo por él.
Listas
| Función | Retorna | Ejemplo → resultado |
|---|
size(x) | Longitud de una lista o string (caracteres), tamaño de un mapa o dimensión de un vector | size('héllo') → 5 |
head(l), last(l) | Primer / último elemento, null para una lista vacía | head([1,2]) → 1 |
tail(l) | Todos los elementos menos el primero | tail([1,2,3]) → [2, 3] |
reverse(x) | Lista o string invertidos | reverse([1,2,3]) → [3, 2, 1] |
range(start, end[, step]) | Rango de enteros inclusivo | range(0, 10, 3) → [0, 3, 6, 9], range(5, 1, -2) → [5, 3, 1] |
coalesce(a, b, …) | Primer argumento no nulo | coalesce(null, 3) → 3 |
Expresiones de listas:
| Forma | Ejemplo → resultado |
|---|
[x IN list WHERE pred | expr] | [x IN range(1,5) WHERE x % 2 = 1 | x * 10] → [10, 30, 50] |
any / all / none / single(x IN list WHERE pred) | single(x IN [1,2] WHERE x = 2) → true |
reduce(acc = init, x IN list | expr) | reduce(s = 0, x IN [1,2,3] | s + x) → 6 |
[(a)-[:T]->(b) | b.name] (pattern comprehension) | lista de los nombres que hicieron match, por fila |
Strings
| Función | Ejemplo → resultado |
|---|
toUpper(s), toLower(s) | toUpper('straße') → 'STRASSE' |
trim(s), ltrim(s), rtrim(s) | trim(' a ') → 'a' |
left(s, n), right(s, n) | left('abc', 2) → 'ab' |
substring(s, start[, length]) | substring('hello', 1, 3) → 'ell' |
replace(s, search, replacement) | replace('aXbX', 'X', '-') → 'a-b-' |
split(s, delimiter) | split('a,b', ',') → ['a', 'b'] |
reverse(s) | reverse('ab') → 'ba' |
size(s) | Cantidad de caracteres |
Conversión
| Función | Comportamiento |
|---|
toString(x) | Forma de texto de un número, booleano, string, fecha o datetime (toString(date('2026-11-01')) → '2026-11-01'). |
toInteger(x) | Desde un string o un número; los flotantes truncan hacia cero (3.7 → 3). Entrada no interpretable → null. |
toFloat(x) | Desde un string o un número. No interpretable → null. |
toBoolean(x) | Desde 'true' / 'false' (sin distinguir mayúsculas), un booleano o los enteros 0 / 1. Cualquier otra cosa → null. |
toStringOrNull, toIntegerOrNull y las demás variantes …OrNull no
están implementadas; las funciones simples ya retornan null para la
entrada que no pueden interpretar.
Matemáticas
| Función | Notas |
|---|
abs(x) | Mismo tipo que la entrada. |
sign(x) | -1, 0 o 1 (entero). |
round(x), floor(x), ceil(x) | Retornan un flotante. round acepta un argumento (sin argumento de precisión); los medios se redondean alejándose de cero. |
sqrt(x) | Flotante; sqrt(-1) es NaN. |
No implementadas: exp, log, log10, e, pi, rand, sin y las
demás funciones trigonométricas.
Fechas y horas
| Función | Retorna |
|---|
date() | Hoy (UTC) como DATE. |
date('YYYY-MM-DD') | Un DATE. Las fechas inválidas son un error. |
datetime() | Ahora como DATETIME en UTC (precisión de microsegundos). |
datetime('ISO-8601') | Un DATETIME en UTC. Los offsets se convierten ('2026-11-01T10:00:00+02:00' → 08:00 UTC); una fecha sola significa medianoche UTC. |
localdatetime(…) | Igual que datetime(…), interpretado como UTC. |
timestamp() | Milisegundos desde el epoch de Unix, como entero. |
Las fechas y los datetimes se comparan con <, = y similares, y se
ordenan correctamente. Los argumentos de mapa (date({year: 2026, …})), el
acceso a componentes (d.year retorna null), duration, time y los
tipos con zona horaria no están soportados. Guarda los instantes como
DATETIME o como enteros de epoch.
Vectores y puntuación de texto
| Función | Retorna |
|---|
vector(list) | Un vector denso de flotantes. size(v) es su dimensión. |
cosine_similarity(a, b) | Similitud coseno; mayor es más cercano. NULL cuando algún vector tiene magnitud cero. |
dot_product(a, b) | Producto punto; mayor es más cercano. |
euclidean_distance(a, b) | Distancia euclidiana (L2); menor es más cercano. |
bm25(text, query) | Una puntuación BM25 por fila de text contra query, sin estadísticas de todo el corpus. |
Las funciones vectoriales aceptan vectores o listas de flotantes y
requieren dimensiones iguales (si no, es un error). Un KNN escrito como
ORDER BY cosine_similarity(n.embedding, $q) DESC LIMIT k usa un índice
vectorial cuando existe; consulta Búsqueda.
Agregaciones
| Función | Notas |
|---|
count(*) | Filas en el grupo. |
count(x) | Valores no nulos. |
sum(x) | 0 si no hay valores. |
avg(x) | Flotante; null si no hay valores. |
min(x), max(x) | Números, strings, fechas. |
collect(x) | Lista de valores no nulos. |
stdev(x), stdevp(x) | Desviación estándar muestral / poblacional. |
percentileCont(x, p), percentileDisc(x, p) | p entre 0.0 y 1.0; valor interpolado / más cercano. |
Todas las agregaciones aceptan DISTINCT: count(DISTINCT n.city),
collect(DISTINCT n.age). Las claves de agrupación son los elementos no
agregados del mismo RETURN o WITH.