Fórmulas y funciones en Notion
A continuación vamos a desglosar detalles técnicos y ejemplos para cada función de Notion, operador y constante, así como los patrones utilizados para formatear fechas usando la función formatDate().
Fórmulas
Las fórmulas son expresiones de cálculo que podemos usar en las propiedades de tipo Fórmula, que pueden estar compuestas de operadores, funciones, valores numéricos, textuales y referencias a propiedades. Siendo las referencias a propiedades lo que nos da la posibilidad de hacer cálculos diferentes y automáticos para cada uno de los registros de la tabla o base de datos introduciéndo una sóla fórmula.
Todas estas funciones, operadores y constantes solo se pueden usar en el entorno de una tabla de Notion y más concretamente dentro de una propiedad de tipo Fórmula.
Funciones
Las funciones nos ayudan a realizar cálculos y operaciones dando un resultado como respuesta. Existen muchas funciones y se pueden clasificar por el tipo de datos que devuelven como resultado. Podemos saber de que tipo son si nos fijamos en el icono que precede a la función en el listado.
El tipo boleano devuelve un resultado de tipo lógico, puede tener dos valores posibles Verdadero o Falso. Notion representa este valor en forma de casilla de chequeo o checkbox, si está chequeada es verdadero y si no es falso.
Características de las funciones
- Todas las funciones tienen esta estructura sintáctica
nombre(parámetro, parámetro). Justo después del nombre de la función siempre se abre paréntesis, sin dejar ningún espacio entre el nombre de la función y el paréntesis. Entre el paréntesis de apertura y cierre pondremos los parámetros, separados por comas, ejemploequal(2, 4). - Hay funciones que no necesitan parámetros, ejemplo
now(). - Podemos incluir como parámetro el valor de una propiedad dentro de una función, ejemplo
day(prop("fecha de alta")). Como vemos en el ejemploprop("fecha de alta")es la forma en que invocamos a la propiedad. - Los parámetros son de tipo texto siempre van entre comillas, ejemplo
length("Hello world"). Si el valor de texto se encuentra dentro de una propiedad no es necesario que añadamos comillas adicionales, ejemplolength(prop("nombre")). - Todas las funciones devuelven un resultado que puede ser un número, un texto, una fecha u hora, o un boleano.
- Las funciones se pueden anidar unas dentro de otras, ejemplo
formatDate(now(), "DD/MM/YYYY")en el ejemplo anidamosnow()dentro deformatDate(). - Podemos realizar operaciones matemáticas con los resultados devueltos por funciones dentro de una misma fórmula, ejemplo
round(prop("total")) + 10
Parámetros y argumentos: estos conceptos pueden crear confusión porque parecen ser lo mismo pero no lo son. Por ejemplo cuando enunciamos la función
subtract(número, número)podemos decir que esta función necesita dos parámetros de tipo numérico, sin embargo en el momento que le estamos pasando datos a la función estos son nombrados como argumentos, ejemplosubtract(5, 3)en este caso 5 y 3 son los argumentos que pasamos a los parámetros de la función. Podríamos decir que parámetro es el contenedor y el argumento el contenido.
Funciones lógicas de Notion
Las funciones lógicas evalúan pruebas lógicas de tipo boleano. A continuación puedes ver una tabla con los operadores lógicos de que podemos usar para realizar estas comparaciones.
| Operador | Descripción | Ejemplo |
|---|---|---|
== | Igual | 2 == 2 → "Coche" == "Casa" → |
!= | Distinto o desigual | 2 != 2 → falso | "Coche" != "Casa" → verdadero |
> | Mayor que | 2 > 2 → falso |
< | Menor que | 2 < 3 → verdadero |
<= | Menor o igual que | 2 >= 3 → falso |
>= | Mayor o igual que | 2 <= 2 → verdadero |
A tener en cuenta
- Cuando comparamos cadenas de texto estas deben ir entre comillas, ejemplo
"Coche" != "Casa". - No se puede comparar en una prueba lógica un número con una cadena de texto ya que son de tipos distintos, pero podemos usar la función
format()(convierte un número en cadena de texto) otoNumber()(convierte una cadena de texto en un número) para convertirlos y poder compararlos. La funcióntoNumber()también puede convertir un boleano en un número si estrue(verdadero) lo convertirá en un1y si esfalse(falso) en un0. - Podemos usar en la prueba lógica propiedades de la tabla, ejemplo
prop("nombre")=="Antonio"oprop("total")>1000. O bien usar funciones anidadas para convertir los valores en el tipo que nos interese para poder compararlos, ejemplotoNumber(prop("valor1"))>prop("valor2").
and(prueba lógica, prueba lógica)
Comprueba si los valores devueltos de dos pruebas lógicas son true o no. Nos devuelve un resultado boleano. Aplicados a una propiedad esta nos muestra un checkbox que en el caso de que el resultado sea true (verdadero) muestra este checkbox chequeado y caso contrario desactivado. Esta función devolverá true si ambas expresiones de comparación son verdaderas y devolverá false si una o ambas son falsas.
Ejemplo 1: and( 2 == 2, 2 == 3 ) → false
Argumento 1: La primera expresión de comparación, debe evaluar a un valor boleano.
Argumento 2: La segunda expresión de comparación, debe evaluar a un valor boleano.
Esta función permite el uso de expresiones regulares, si quieres aprender a usarlas haz clic aquí.
Ejemplo 2: and(prop("Prop 1"), prop("Prop 2") >= 10)
Argumento 1: En el primer argumento no hace falta poner ninguna expresión de comparación ya que el propio argumento es boleano debido a que la Propiedad “Prop 1” es de tipo Checkbox, por lo tanto el propio argumento nos proporciona un true o un false.
Argumento 2: El segundo argumento evalúa si el valor de la propiedad “Prop 2” en cada fila es mayor o igual a 10.
empty(valor)
Comprueba si el argumento está vacío, si está vacío de vuelve true, si está lleno false. Devuelve un boleano.
Ejemplo 1: empty( "Mundo" ) → false
Ejemplo 2: empty( "" ) → true
Argumento: La expresión a comprobar, que puede evaluar cualquier tipo de valor, por ejemplo, un número, cadena de texto o fecha.
Ejemplo 3: empty(prop("Valor"))
Argumento: Evalúa si el valor de la propiedad “Valor” en cada fila está vacío o no. En caso de que la propiedad esté vacía nos proporciona un true y cuando no false.
equal(valor, valor)
Comprueba si los valores devueltos de dos expresiones son iguales. Devuelve un boleano.
Ejemplo 1: equal( 2, 3 ) → false
Ejemplo 2: equal( "rojo", "azul" ) → false
Ejemplo 3: equal(3 * 5, 15 ) → true
Ejemplo 4: equal( false, not true ) → true
Operador equivalente: [expresión] == [expresión]
Argumento 1: La expresión a comprobar, que puede evaluar cualquier tipo de valor, por ejemplo, un número, cadena de texto, fecha o boleano.
Argumento 2: La expresión a comprobar, que puede evaluar cualquier tipo de valor, por ejemplo, un número, cadena de texto, fecha o boleano.
Ejemplo: equal(prop("Valor 1"), prop("Valor 2"))
Argumentos: Evalúa si el valor de la propiedad “Valor 1” y “Valor 2” son iguales. En caso de que ambas propiedades sean iguales nos proporciona un true y cuando no false.
if(prueba lógica, valor, valor)
La función if() permite realizar una acción si se cumple una condición, u otra acción si la condición no se cumple. Al anidar las funciones if() (colocarlas una dentro de la otra), puedes especificar acciones para numerosas condiciones. Esta función necesita tres parámetros:
- Prueba lógica, que se evalúa como
verdaderoofalso. - Valor u operación a devolver si la operación si es
verdadero. - Valor u operación a devolver si la operación si es
falso.
Ejemplo 1: if(prop("Valor 1") > prop("Valor 2"), "Es mayor", "Es menor o igual")
Argumento 1: Evalúa si el valor de la propiedad “Valor 1” es mayor que la propiedad “Valor 2”. Solo en caso de que “Valor 1” sea mayor que “Valor 2” el resultado de la prueba lógica será true (Verdadero).
Argumento 2: Si la prueba lógica da como resultado true, el resultado a mostrar será “Es mayor”.
Argumento 3: Si la prueba lógica da como resultado false, el resultado a mostrar será “Es menor o igual”.
Dado que esta fórmula anidada es un poco más compleja vamos a ver estos ejemplos en un nuevo video explicativo.
Ejemplo 2: if(prop("Valor 1") > prop("Valor 2"), "Es mayor", if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual"))
Argumento 1: Evalúa si el valor de la propiedad “Valor 1” es mayor que la propiedad “Valor 2”. Solo en caso de que “Valor 1” sea mayor que “Valor 2” el resultado de la prueba lógica será true (Verdadero).
Argumento 2: Si la prueba lógica da como resultado true, el resultado a mostrar será “Es mayor”.
Argumento 3: Si la prueba lógica da como resultado false, como tercer argumento incluimos un nuevo if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual") anidado, este if tiene a su vez tres parámetros.
Esta función permite el uso de expresiones regulares, si quieres aprender a usarlas haz clic aquí.
larger(valor, valor)
Devuelve true (verdadero) si el primer argumento es más grande que el segundo y false (falso) en caso contrario. Podemos evaluar cualquier tipo de valor, textos, números, fechas o boleanos. En caso de que los valores sean iguales devolvería false. Ambos parámetros deben ser del mismo tipo (número, texto, …). Devuelve un boleano.
Ejemplo 1: larger("Ac","Ab") → true
Ejemplo 2: larger(2,3) → false
Ejemplo 3: larger(prop("Fecha 1"),prop("Fecha 2")) → true
Ejemplo 4: larger(true, false) → true
Argumento 1: La primera expresión, que puede evaluar cualquier tipo de valor, por ejemplo, a número, texto, fecha o boleano.
Argumento 2: La expresión contra la cual comparar el primero. Su tipo de valor debe coincidir con el tipo de valor de la primera expresión.
¿Cómo se evalúan los textos con larger()? primero evalúa la letra más a la izquierda de cada argumento, en el ejemplo 1 como la primera letra es la “A” en ambos argumentos, pasa a evaluar la segunda letra en este caso la “c” del primer argumento es mayor que la “b” del segundo argumento porque las letras tienen el valor de su orden en el abecedario y en este caso la “c” está en la tercera posición y por lo tanto es mayor que la “b” del segundo argumento. Cuaquier letra minúscula es mayor que cualquiera mayúscula.
¿Y las fechas? la fecha más actual siempre es la mayor.
Los boleanos, si es true tiene valor 1 y si es false tiene valor 0. Por lo tanto el valor true siempre es mayor que el false.
largerEq(valor, valor)
Es igual que la anterior con la diferencia de que esta función también nos devuelve true en caso de que los argumentos sean iguales. Devuelve true (verdadero) si el primer argumento es más grande o igual que el segundo y false (falso) en caso de ser menor. Podemos evaluar cualquier tipo de valor, textos, números, fechas o boleanos. Ambos parámetros deben ser del mismo tipo (número, texto, …). Devuelve un boleano.
Ejemplo 1: largerEq("Ac","Ab") → true
Ejemplo 2: largerEq(2,2) → true
Ejemplo 3: largerEq(prop("fecha 1"),prop("fecha 2")) → true
Ejemplo 4: largerEq(true, false) → true
Argumento 1: La primera expresión, que puede evaluar cualquier tipo de valor, por ejemplo, a número, texto, fecha o boleano.
Argumento 2: La expresión contra la cual comparar el primero. Su tipo de valor debe coincidir con el tipo de valor de la primera expresión.
¿Cómo se evalúan los textos con larger()? primero evalúa la letra más a la izquierda de cada argumento, en el ejemplo 1 como la primera letra es la “A” en ambos argumentos, pasa a evaluar la segunda letra en este caso la “c” del primer argumento es mayor que la “b” del segundo argumento porque las letras tienen el valor de su orden en el abecedario y en este caso la “c” está en la tercera posición y por lo tanto es mayor que la “b” del segundo argumento. Cuaquier letra minúscula es mayor que cualquiera mayúscula.
¿Y las fechas? la fecha más actual siempre es la mayor.
Los boleanos, si es true tiene valor 1 y si es false tiene valor 0. Por lo tanto el valor true siempre es mayor que el false.
not(prueba lógica)
Comprueba si la prueba lógica devuelve false. Si la prueba lógica es false devuelve true y viceversa. Devuelve un boleano.
Ejemplo 1: not(2 == 3) → true
Ejemplo 2: not(prop("País 1") == prop("País 2"))
Ejemplo 3: not prop("País 1") == prop("País 2")
El Ejemplo 3 hace la misma función que el Ejemplo 2, de Notion cuando introducimos la expresión de la forma que vemos en el Ejemplo 2 una vez pulsamos el botón Done la cambia a como la vemos en el Ejemplo 3.
Argumento 1: La prueba lógica evualua un boleano. En este caso avalúa si 2 == 3 el resultado es false (falso). La función devuelve el boleano contrario al resultado de la prueba lógica true.
Ejemplo 4: if (not prop("Finalizado"), "No finalizado", "Finalizado")
En este ejemplo hemos incluido not anidado en una función if(), como vemos esta función pierde los parentesis y funciona como un operador de negación.
Esta función permite el uso de expresiones regulares, si quieres aprender a usarlas haz clic aquí.
or(prueba lógica, prueba lógica)
Si una o ambas pruebas lógicas devuelve true. En caso de ambas sean false, devuelve false. Devuelve un boleano.
Ejemplo 1: or(2==2, 1==3) → true
Ejemplo 2: or(2==4, 1==3) → false
Argumento 1: La primera expresión de comparación, debe evaluar una prueba lógica dando como resultado un valor boleano.
Argumento 2: La segunda expresión de comparación, debe evaluar una prueba lógica dando como resultado un valor boleano.
Esta función permite el uso de expresiones regulares, si quieres aprender a usarlas haz clic aquí.
smaller(valor, valor)
Devuelve true (verdadero) si el primer argumento es más pequeño que el segundo y false (falso) en caso contrario. Podemos evaluar cualquier tipo de valor, textos, números, fechas o boleanos. En caso de que los valores sean iguales devolvería false. Ambos parámetros deben ser del mismo tipo (número, texto, …). Devuelve un boleano.
Ejemplo 1: smaller( "Ac","Ab") → false
Ejemplo 2: smaller( 2, 3 ) → true
Ejemplo 3: smaller(prop("Fecha 1"),prop("Fecha 2")) → false
Ejemplo 4: smaller( true, false ) → false
Argumento 1: La primera expresión, que puede evaluar cualquier tipo de valor, por ejemplo, a número, texto, fecha o boleano.
Argumento 2: La expresión contra la cual comparar el primero. Su tipo de valor debe coincidir con el tipo de valor de la primera expresión.
¿Cómo se evalúan los textos con larger()? primero evalúa la letra más a la izquierda de cada argumento, en el ejemplo 1 como la primera letra es la “A” en ambos argumentos, pasa a evaluar la segunda letra en este caso la “c” del primer argumento es mayor que la “b” del segundo argumento porque las letras tienen el valor de su orden en el abecedario y en este caso la “c” está en la tercera posición y por lo tanto es mayor que la “b” del segundo argumento. Cuaquier letra minúscula es mayor que cualquiera mayúscula.
¿Y las fechas? la fecha más actual siempre es la mayor.
Los boleanos, si es true tiene valor 1 y si es false tiene valor 0. Por lo tanto el valor true siempre es mayor que el false.
smallerEq(valor, valor)
Devuelve true (verdadero) si el primer argumento es más pequeño que el segundo y false (falso) en caso contrario. Podemos evaluar cualquier tipo de valor, textos, números, fechas o boleanos. En caso de que los valores sean iguales devolvería true. Ambos parámetros deben ser del mismo tipo (número, texto, …). Devuelve un boleano.
Ejemplo 1: smallerEq( "Ac","Ab") → false
Ejemplo 2: smallerEq( 2, 3 ) → true
Ejemplo 3: smallerEq(prop("Fecha 1"),prop("Fecha 2")) → false
Ejemplo 4: smallerEq( true, false ) → false
Argumento 1: La primera expresión, que puede evaluar cualquier tipo de valor, por ejemplo, a número, texto, fecha o boleano.
Argumento 2: La expresión contra la cual comparar el primero. Su tipo de valor debe coincidir con el tipo de valor de la primera expresión.
¿Cómo se evalúan los textos con larger()? primero evalúa la letra más a la izquierda de cada argumento, en el ejemplo 1 como la primera letra es la “A” en ambos argumentos, pasa a evaluar la segunda letra en este caso la “c” del primer argumento es mayor que la “b” del segundo argumento porque las letras tienen el valor de su orden en el abecedario y en este caso la “c” está en la tercera posición y por lo tanto es mayor que la “b” del segundo argumento. Cuaquier letra minúscula es mayor que cualquiera mayúscula.
¿Y las fechas? la fecha más actual siempre es la mayor.
Los boleanos, si es true tiene valor 1 y si es false tiene valor 0. Por lo tanto el valor true siempre es mayor que el false.
unequal(valor, valor)
Comprueba si los valores devueltos de dos expresiones son desiguales. Devuelve un boleano.
Ejemplo 1: unequal( 2, 3 ) → true
Ejemplo 2: unequal( "rojo", "rojo" ) → false
Ejemplo 3: unequal(6 * 9, 42 ) → false
Ejemplo 4: unequal( true, not false ) → false
Operador equivalente: [expresión] != [expresión]
Argumento 1: La expresión a comprobar, que puede evaluar cualquier tipo de valor, por ejemplo, un número, cadena de texto, fecha o boleano.
Argumento 2: La expresión a comprobar, que puede evaluar cualquier tipo de valor, por ejemplo, un número, cadena de texto, fecha o boleano.
Funciones numéricas de Notion
Las funciones numéricas realizan operaciones matemáticas con números y siempre devuelven un número. A continuación puedes ver una tabla con los operadores matemáticos de que podemos usar para realizar estas operaciones.
| Operador | Descripción | Ejemplos |
|---|---|---|
- | Resta el operando derecho del operando izquierdo para devolver su diferencia. | 4 - 2 → 2 |
+ | Suma operandos numéricos para devolver su suma, o concatena (combina) operandos textuales (cadenas de texto). | 2 + 2 → 4 |
* | Multiplica sus operandos para devolver su producto. | 3 * 6 → 18 |
/ | Divide el operando izquierdo por el operando derecho para devolver su cociente. | 21 / 7 → 3 |
% | El operador de módulo devuelve el resto después de dividir el operando izquierdo por el operando derecho. | 23 % 7 → 2 |
^ | Devuelve el valor de base elevado a la potencia. | 2 ^ 4 → 16 |
abs(número)
Devuelve el valor absoluto de un número. Devuelve un número.
Ejemplo 1: abs( -3 ) → 3
Argumento 1: El número del que queremos obtener el valor absoluto.
add(valor, valor)
Suma dos números y devuelve la suma de ambos. También concatena dos cadenas de caracteres y devuelve la suma de ambas. Devuelve un número o un texto dependiendo el tipo de sus argumentos.
Ejemplo 1: add( 3 , 4 ) → 7
Ejemplo 2: add( "Hola " , "mundo" )Hola mundo
Argumento 1: Primer número o texto de la suma o concatenación.
Argumento 2: Segúndo número o texto de la suma o concatenación.
cbrt(número)
Devuelve la raiz cúbica de un número. Devuelve un número.
Ejemplo 1: cbrt( 8 ) → 2
Argumento 1: El número del que queremos obtener la raiz cúbica.
ceil(número)
Devuelve el número entero más pequeño mayor o igual que un número. Devuelve un número.
Ejemplo 1: ceil( 4.2 ) → 5
Argumento 1: El número del que queremos obtener el entero superior o igual más cercano.
Notion usa punto como separador para los decimales.
divide(número, número)
Divide dos números y devuelve su cociente. Devuelve un número.
Ejemplo 1: divide( 21, 7 ) → 3
Argumento 1: Dividendo.
Argumento 1: Divisor.
exp(número)
Devuelve E ^ x, donde x es el argumento y E es la constante de Euler (2,718…), la base del logaritmo natural. Devuelve un número.
Ejemplo 1: exp( 2 ) → 7.389056098931
Argumento 1: El número que servirá como exponente de E.
floor(número)
Devuelve el número entero más grande menor o igual que un número. Devuelve un número.
Ejemplo 1: floor( 4.2 ) → 4
Argumento 1: El número del que queremos obtener el entero menor o igual más cercano.
Notion usa punto como separador para los decimales.
ln(número)
Devuelve el logaritmo natural conocido como logaritmo neperiano de un número. Devuelve un número.
Ejemplo 1: ln( 3 ) → 1.098612288668
Argumento 1: El número del que queremos obtener el logaritmo neperiano.
log10(número)
Devuelve el logaritmo en base 10 de un número. Devuelve un número.
Ejemplo 1: log10( 100 ) → 2
Argumento 1: El número del que queremos obtener el logaritmo en base 10.
log2(número)
Devuelve el logaritmo en base 2 de un número. Devuelve un número.
Ejemplo 1: log2( 8 ) → 3
Argumento 1: El número del que queremos obtener el logaritmo en base 2.
max(número, número, número, …)
Devuelve el número mayor de una lista, podemos añadir tantos números como queramos separados por comas. Devuelve un número.
Ejemplo 1: max( 2, 5, 7, 21, 3 ) → 21
Argumentos 1, 2, 3, …: Lista de números separados por comas.
min(número, número, número, …)
Devuelve el número menor de una lista, podemos añadir tantos números como queramos separados por comas. Devuelve un número.
Ejemplo 1: min( 2, 5, 7, 21, 3 ) → 2
Argumentos 1, 2, 3, …: Lista de números separados por comas.
mod(número, número)
Divide dos numeros y devuelve el resto. Devuelve un número.
Ejemplo 1: mod( 7, 3 ) → 1
Argumentos 1: Dividendo.
Argumentos 1: Divisor.
multiply(número, número)
Multiplica dos números y devuelve su producto. Devuelve un número.
Ejemplo 1: multiply( 2 , 3 ) → 6
Argumento 1: Primer número o factor de la multiplicación.
Argumento 2: Segundo número o factor de la multiplicación.
pow(número, número)
Devuelve la base a la potencia del exponente. Devuelve un número.
Ejemplo 1: pow( 2 , 5 ) → 32
Argumento 1: Base.
Argumento 2: Exponente.
round(número)
Devuelve el valor de un número redondeado al entero más cercano. Devuelve un número.
Ejemplo 1: round( 4.4 ) → 4
Ejemplo 1: round( 4.5 ) → 5
Argumento 1: Número a redondear.
sign(número)
Devuelve el signo de un número, si es positivo devuelve 1, si es negativo devuelve -1 y si es cero devuelve 0. Devuelve un número.
Ejemplo 1: sign( -9 ) → -1
Ejemplo 1: sign( 5 ) → 1
Ejemplo 1: sign( 0 ) → 0
Argumento 1: Número del que queremos devolver el signo.
sqrt(número)
Devuelve la raíz cuadrada de un número. Devuelve un número.
Ejemplo 1: sqrt( 16 ) → 4
Argumento 1: Número del que queremos devolver la raíz cuadrada.
subtract(número, número)
Resta dos números y devuelve su diferencia. Devuelve un número.
Ejemplo 1: subtract( 4 , 3 ) → 1
Argumento 1: Primer número o minuendo de la resta.
Argumento 2: Segundo número o sustraendo de la resta.
toNumber(texto)
Convierte un texto en un número. Si la cadena de texto comienza con un número seguido de texto, toma ese número y lo devuelve como resultado. Devuelve un número.
Ejemplo 1: toNumber( "7" ) → 7
Ejemplo 1: toNumber( "51 productos" ) → 51
Argumento 1: El número a convertir.
unaryMinus(número)
Convierte un número negativo en positivo o un número positivo en negativo. Devuelve un número.
Ejemplo 1: unaryMinus( -2 ) → 2
Ejemplo 2: unaryMinus( 3 ) → -3
Argumento 1: El número a convertir.
Operador equivalente: [número] * -1
unaryPlus(texto)
Convierte un texto en un número. Si la cadena de texto comienza con un número seguido de texto, a diferencia de toNumber() no toma ese número y devuelve el campo vacío. Devuelve un número.
Ejemplo 1: unaryPlus( "7" ) → 7
Ejemplo 1: unaryPlus( "51 productos" ) →
Argumento 1: El texto a convertir.
Funciones de textos de Notion
Funciones con las que podrás realizar cambios y procesos relacionados con textos o propiedades que contengan textos.
concat(texto, texto, …)
Concatena o combina textos, no tiene límite de argumentos, pueden ser tantos como quieras incluir. Devuelve un texto.
Ejemplo 1: concat( "La ","Colmena ", "Tecnológica" ) → "La Colmena Tecnológica"
Argumentos: Los textos para concatenar.
contains(texto, texto)
Devuelve true (verdadero) si el segundo argumento es encontrado en el primero. Devuelve un boleano.
Ejemplo 1: contains( "notion","ion" ) → true
Ejemplo 1: contains( "La Colmena","Tec" ) → false
Argumento 1: El texto donde queremos buscar.
Argumento 1: El texto a buscar.
format(valor)
Convierte un número, fecha o boleano en un texto. Devuelve un texto.
Ejemplo 1: format( 3 ) → "3"
Argumento 1: Número, fecha o boleano a convertir.
join(texto, texto, …)
Concatena o combina textos con un delimitador espefificado. Devuelve un texto.
Ejemplo 1: join( ", ","Olga", "María", "Fernando", "Luisa" ) → "Olga, María, Fernando, Luisa"
Argumentos: El primer argumento es el delimitador, una cadena de texto. Los argumentos restantes son los textos que se combinarán separados con el delimitador. Podemos incluir tantos argumentos como queramos.
length(texto, expresión, texto)
Devuelve el número de caracteres en una cadena de texto. Devuelve un texto.
Ejemplo 1: length( "La Colmena Tecnológica" ) → 22
Argumento 1: El texto para el que devolver la longitud.
replace(texto, expresión, texto)
Reemplaza la primera coincidencia de una expresión regular dentro de una cadena de texto por un nuevo texto especificado. Devuelve una cadena de texto.
Ejemplo 1: replace( "La verdad", "La", "Es" ) → "Es verdad"
Ejemplo 2: replace("1-2-3", "-", "!") → "1!2-3"
Ejemplo 3: replace("Mi nombre es Isabel", "(?<=es ).+(?=\.)", "María") → "Mi nombre es María"
Argumento 1: El texto original.
Argumento 2: Texto o Expresión regular (entre comillas).
Argumento 3: El texto de reemplazo.
El Ejemplo 3 usa expresiones regulares, si quieres aprender a usarlas haz clic aquí
replaceAll(texto, expresión, texto)
Reemplaza la primera coincidencia de una expresión regular dentro de una cadena de texto por un nuevo texto especificado. Devuelve una cadena de texto.
Ejemplo 1: replaceAll( "Me gusta el verano. Me gusta nadar", "Me gusta", "Me encanta" ) → "Me encanta el verano. Me encanta nadar."
Ejemplo 2: replaceAll(prop("Nombre"), "Dra?. ", "") → Sustituye "Dr. " o "Dra. " que hubiera cualquier registro de la tabla por nada "", es decir los elimina.
Argumento 1: El texto original.
Argumento 2: Texto o Expresión regular (entre comillas).
Argumento 3: El texto de reemplazo.
El Ejemplo 3 usa expresiones regulares, si quieres aprender a usarlas haz clic aquí
slice(texto, número, número)
La función slice() nos devuelve un segmento o parte del texto que le hayamos proporcionado. Esta función necesita al menos dos parámetros, aunque opcionalmente podemos usar tres:
- Texto origal del que vamos a obtener una parte.
- Punto de inicio, donde el primer caracter es
0. - Punto final (opcional)
Ejemplo 1: slice("La Colmena Tecnológica.", 3, 10) → “Colmena”
Ejemplo 2: slice("La Colmena Tecnológica.", 11, 22) → “Tecnológica”
Los espacios en blanco también cuentan como un carácter. El parámetro punto final a deferencia del punto de inicio no incluye el carácter, por eso para incluir el caracter final deberemos poner la posición justo después a este.
test(prueba)
Comprueba si una cadena de texto coincide con una expresión regular. Devuelve un boleano.
Ejemplo 1: test( "Rojo, Verde, Azul", "Verde" ) → true
Ejemplo 2: test(prop("Nombre"), "^A|^C") → Devuelve true para cualquier nombre que empiece por A o por C.
Argumento 1: El texto original.
Argumento 2: Texto o Expresión regular (entre comillas).
Argumento 3: El texto de reemplazo.
El Ejemplo 3 usa expresiones regulares, si quieres aprender a usarlas haz clic aquí
Funciones Fecha y hora de Notion
Son funciones que nos ayudan a realizar operaciones con propiedades de tipo fecha y hora. Por ejemplo, para calcular cuantos diás han pasado entre dos fechas, extraer un solo dato de una fecha (día, mes, año) y mucho más. Vamos a conocer cada una de estas funciones.
date(fecha)
Devuelve el día del mes, un número entero entre 1 y 31, para una determinada fecha. Devuelve a number.
Ejemplo 1: date(now()) → 26
Ejemplo 2: date(prop("Fecha")) → Devuelve día que tenga la fecha de la propiedad Fecha.
Argumento 1: La fecha a partir del cual identificar el día del mes.
Notion solo permite obtener una fecha a través de una propiedad de tipo Date (fecha y hora) o a través de la función now() que devuelve la fecha y hora actual.
dateAdd(fecha, número, texto)
Sumar tiempo a una fecha. El último argumento, que puede ser uno de estos: "years" (años), "quarters" (trimestres), "months" (meses), "weeks" (semanas), "days" (días), "hours" (horas), "minutes" (minutos), "seconds" (segundos), o "miliseconds" (milisegundos). Devuelve una fecha.
Ejemplo 1: dateAdd(now(), 1, "months") → Supongamos que hoy es 15/08/2021, el resultado es Sep 15, 2020 10:46 AM (este resultado se puede formatear con la función formatDate().
Argumento 1: La fecha inicial.
Argumento 2: La cantidad a agregar.
Argumento 3: La unidad de tiempo, que puede ser años, trimestres, meses, semanas, días, horas, minutos, segundos, milisegundos, entre comillas.
Notion solo permite obtener una fecha a través de una propiedad de tipo Date (fecha y hora) o a través de la función now() que devuelve la fecha y hora actual.
dateBetween(fecha, fecha, texto)
Devuelve la cantidad de tiempo entre dos fechas. El último argumento, que puede ser uno de estos: "years" (años), "quarters" (trimestres), "months" (meses), "weeks" (semanas), "days" (días), "hours" (horas), "minutes" (minutos), "seconds" (segundos), o "miliseconds" (milisegundos). Devuelve un número.
Ejemplo 1: dateBetween(now(), prop("Created time"), "minutes") → 43
Argumento 1: La fecha mayor.
Argumento 2: La fecha menor.
Argumento 3: La unidad de tiempo, que puede ser años, trimestres, meses, semanas, días, horas, minutos, segundos, milisegundos, entre comillas.
Notion solo permite obtener una fecha a través de una propiedad de tipo Date (fecha y hora) o a través de la función now() que devuelve la fecha y hora actual.
dateSubtract(fecha, número, texto)
Restar tiempo a una fecha. El último argumento, que puede ser uno de estos: "years" (años), "quarters" (trimestres), "months" (meses), "weeks" (semanas), "days" (días), "hours" (horas), "minutes" (minutos), "seconds" (segundos), o "miliseconds" (milisegundos). Devuelve una fecha.
Ejemplo 1: dateSubtract(now(), 1, "years") → Supongamos que hoy es 15/08/2021, el resultado es Aug 15, 2020 11:45 AM (este resultado se puede formatear con la función formatDate()).
Argumento 1: La fecha inicial.
Argumento 2: La cantidad a restar.
Argumento 3: La unidad de tiempo, que puede ser años, trimestres, meses, semanas, días, horas, minutos, segundos, milisegundos, entre comillas.
Notion solo permite obtener una fecha a través de una propiedad de tipo Date (fecha y hora) o a través de la función now() que devuelve la fecha y hora actual.
day(fecha)
Devuelve el índice (número) del día de la semana para una fecha, donde el domingo es 0, el lunes 1, y así susesivamente. Devuelve un número.
Ejemplo 1: day(now()) → 5
Argumento 1: La fecha para la que identificar el día de la semana.
Notion solo permite obtener una fecha a través de una propiedad de tipo Date (fecha y hora) o a través de la función now() que devuelve la fecha y hora actual.
end(fecha)
Devuelve la fecha final de una propiedad de fecha que contiene un rango de fechas. Devuelve una fecha.
Ejemplo 1: end(prop("Duración")) → Jun 27, 2020 21:15 AMformatDate()).
Argumento 1: Una referencia a una propiedad de tipo Date que contiene una fecha final.
formatDate(fecha, text)
Formatea una fecha con la cadena de formato de tiempo estándar de Moment.
Ejemplo 1: formatDate(now(),"DD/MM/YYYY") → 26/04/2024
Argumento 1: La propiedad fecha o now() que queremos formatear.
Argumento 2: Formato de tiempo estandar de Moment entre comillas.
Formatos de fecha
Combina estos patrones para construir el segundo argumento de la función.
| Categoría | Patrón | Representación |
|---|---|---|
| Año | YYYYYY | 24 2024 |
| Trimestre | QQo | 1 … 4 1º … 4º |
| Mes | MMoMMMMMMMMM | 1 … 12 1º … 12º 01 … 12 jun january |
| Semana del año | wwoww | 1 … 53 1º … 53º 01 … 53 |
| Día del año | DDDDDDoDDDD | 1 … 365 1º … 365º 001 … 365 |
| Día | DDoDD | 1 … 31 1º … 31º 01 … 31 |
| Día de la semana | dddddddddd | 0 … 6 Su Sun Sunday |
| 24 horas | HHH | 0 … 23 00 … 23 |
| 12 horas | hhh | 1 … 12 01 … 12 |
| Minutos | m | 0 … 59 00 … 59 |
| Segundos | sss | 0 … 59 00 … 59 |
| AM / PM | aA | a.m A.M |
| Desplazamiento de zona horaria | ZZZ | +02:00 +0200 |
| Segundos precisos | SSS | 0 … 9 00 … 99 |
| Milisegundos | SSS | 000 … 999 |
| Marca de de tiempo de Unix | X | 1597491300 |
| Marca de tiempo Unix de milisegundos | x | 1597491300000 |
fromTimestamp(número)
Devuelve un valor de fecha desde una marca de tiempo en milisegundos de Unix, o número de milisegundos desde el 1 de enero de 1970. Devuelve una fecha.
Ejemplo 1: fromTimestamp(159749388000) → Aug 15, 2020 14:19 AMformatDate()).
Argumento 1: Número de una marca de tiempo en milisegundos de Unix, o número de milisegundos que han pasado desde el 1 de enero de 1970.
hour(fecha)
Devuelve la hora del día, un número entero entre 0 y 23 de una fecha. Devuelve un número.
Ejemplo 1: hour(now()) → 12
Argumento 1: El valor fecha/hora del que queremos obtener la hora del día.
minute(fecha)
Devuelve el minuto de la hora, un número entero entre 0 y 59 de una fecha. Devuelve un número.
Ejemplo 1: minute(now()) → 32
Argumento 1: El valor fecha/hora del que queremos obtener el minuto.
month(fecha)
Devuelve el índice númerico del mes del año, un número entero entre 0 y 11 de una fecha, donde enero es el 0, febrero es el 1, … Devuelve un número.
Ejemplo 1: month(now()) → 7
Argumento 1: La fecha de la que queremos obtener el índice númerico del mes del año.
now()
Devuelve la fecha actual. Devuelve una fecha.
Ejemplo 1: now() → Aug 15, 2021 14:34 PM
Argumentos: Esta función no lleva argumentos.
start(fecha)
Devuelve la fecha inicial de una propiedad de fecha que contiene un rango de fechas. Devuelve una fecha.
Ejemplo 1: start(prop("Duración")) → Jun 01, 2020 21:15 AMformatDate()).
Argumento 1: Una referencia a una propiedad de tipo Date que contiene una fecha inicial.
timestamp(fecha)
Devuelve la marca de tiempo en milisegundos de Unix, o número de milisegundos desde el 1 de enero de 1970 de la fecha dada. Devuelve una fecha.
Ejemplo 1: timestamp(now()) → 159749388000
Argumento 1: La fecha de la que queremos obtener al marca de tiempo.
year(fecha)
Devuelve el año de una fecha. Devuelve un número.
Ejemplo 1: year(now()) → 2024
Argumento 1: La fecha de la que queremos obtener año.
Constantes
Son valores fijos que no pueden ser alterados o modificados, únicamente puede ser leídos. Podemos usarlos en las fórmulas:
| Constante | Descripción | Valor |
|---|---|---|
e | La base del logaritmo natural o neperiano. | 2.718281828459 |
false | Falso o 0 | false |
true | Verdadero o 1 | true |
pi | La razón entre la circunferencia de un círculo y su diámetro | 3.14159265359 |
