Tableaux dans Notion : formules et fonctions

Table des matières

[mepr-show rules=»7898″ unauth=»message»]

https://vimeo.com/401908864

Cliquez sur le bouton PLAY pour voir la vidéo

[/mepr-show]

Formules et fonctions dans Notion

Nous allons maintenant détailler les aspects techniques et des exemples pour chaque fonction, opérateur et constante de Notion, ainsi que les modèles utilisés pour formater les dates avec la fonction formatDate().

Formules

Les formules sont des expressions de calcul que nous pouvons utiliser dans les propriétés de type Formule. Elles peuvent être composées d’opérateurs, de fonctions, de valeurs numériques, textuelles et de références à des propriétés. Les références à des propriétés nous donnent la possibilité d’effectuer des calculs différents et automatiques pour chacun des enregistrements du tableau ou de la base de données, en saisissant une seule formule.

Toutes ces fonctions, opérateurs et constantes ne peuvent être utilisés que dans l’environnement d’un tableau Notion, et plus précisément au sein d’une propriété de type Formule.

Fonctions

Les fonctions nous aident à effectuer des calculs et des opérations en renvoyant un résultat. Il existe de nombreuses fonctions, que l’on peut classer selon le type de données qu’elles renvoient. Nous pouvons savoir de quel type il s’agit en regardant l’icône qui précède la fonction dans la liste.

Le type booléen renvoie un résultat logique, avec deux valeurs possibles : Vrai ou Faux. Notion représente cette valeur sous forme de case à cocher (checkbox) : si elle est cochée, c’est vrai ; sinon, c’est faux.

Caractéristiques des fonctions

Toutes les fonctions ont cette structure syntaxique nombre(parámetro, parámetro). Juste après le nom de la fonction, une parenthèse s’ouvre toujours, sans laisser d’espace entre le nom de la fonction et la parenthèse. Entre la parenthèse ouvrante et la parenthèse fermante, nous mettrons les paramètres, séparés par des virgules, par exemple equal(2, 4).
Certaines fonctions n’ont pas besoin de paramètres, par exemple now().
Nous pouvons inclure, comme paramètre, la valeur d’une propriété dans une fonction, par exemple day(prop("fecha de alta")). Comme on le voit dans l’exemple, prop("fecha de alta") est la manière dont nous appelons la propriété.
Les paramètres de type texte sont toujours entre guillemets, par exemple length("Hello world"). Si la valeur textuelle se trouve dans une propriété, il n’est pas nécessaire d’ajouter des guillemets supplémentaires, par exemple length(prop("nombre")).
Toutes les fonctions renvoient un résultat qui peut être un nombre, un texte, une date ou une heure, ou un booléen.
Les fonctions peuvent être imbriquées les unes dans les autres, par exemple formatDate(now(), "DD/MM/YYYY") ; dans l’exemple, nous imbriquons now() dans formatDate().
Nous pouvons effectuer des opérations mathématiques avec les résultats renvoyés par des fonctions au sein d’une même formule, par exemple round(prop("total")) + 10

Paramètres et arguments : ces concepts peuvent prêter à confusion, car ils semblent identiques, mais ne le sont pas. Par exemple, lorsque nous énonçons la fonction subtract(número, número), nous pouvons dire que cette fonction nécessite deux paramètres de type numérique ; cependant, au moment où nous lui passons des données, celles-ci sont appelées des arguments, par exemple subtract(5, 3). Dans ce cas, 5 et 3 sont les arguments que nous passons aux paramètres de la fonction. On pourrait dire que le paramètre est le contenant et l’argument le contenu.

Fonctions logiques de Notion

Les fonctions logiques évaluent des tests logiques de type booléen. Vous pouvez voir ci-dessous un tableau avec les opérateurs logiques que nous pouvons utiliser pour effectuer ces comparaisons.

Opérateur	Description	Exemple
`==`	Égal	`2 == 2` → `verdadero` \| `"Coche" == "Casa"` → `falso`
`!=`	Différent ou inégal	`2 != 2` → `falso` \| `"Coche" != "Casa"` → `verdadero`
`>`	Supérieur à	`2 > 2` → `falso`
`<`	Inférieur à	`2 < 3` → `verdadero`
`<=`	Inférieur ou égal à	`2 >= 3` → `falso`
`>=`	Supérieur ou égal à	`2 <= 2` → `verdadero`

À prendre en compte

Lorsque nous comparons des chaînes de texte, elles doivent être entre guillemets, par exemple "Coche" != "Casa".
Il n’est pas possible de comparer, dans un test logique, un nombre avec une chaîne de texte, car ce sont des types différents. Toutefois, nous pouvons utiliser la fonction format() (convertit un nombre en chaîne de texte) ou toNumber() (convertit une chaîne de texte en nombre) pour les convertir et pouvoir les comparer. La fonction toNumber() peut également convertir un booléen en nombre : s’il est true (vrai), elle le convertira en 1, et s’il est false (faux), en 0.
Nous pouvons utiliser, dans le test logique, des propriétés du tableau, par exemple prop("nombre")=="Antonio" ou prop("total")>1000. Ou bien utiliser des fonctions imbriquées pour convertir les valeurs dans le type qui nous intéresse afin de pouvoir les comparer, par exemple toNumber(prop("valor1"))>prop("valor2").

and(test logique, test logique)

Vérifie si les valeurs renvoyées par deux tests logiques sont true ou non. Renvoie un résultat booléen. Appliquée à une propriété, celle-ci affiche une case à cocher : si le résultat est true (vrai), la case est cochée ; sinon, elle est décochée. Cette fonction renverra true si les deux expressions de comparaison sont vraies, et renverra false si l’une ou les deux sont fausses.

Exemple 1 : and( 2 == 2, 2 == 3 ) → false

Argument 1 : La première expression de comparaison doit s’évaluer en une valeur booléenne.

Argument 2 : La deuxième expression de comparaison doit s’évaluer en une valeur booléenne.

Cette fonction permet l’utilisation d’expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici.

Notion Funcion and() — La formule est incluse dans la propriété Ʃ Formule

Exemple 2 : and(prop("Prop 1"), prop("Prop 2") >= 10)

Argument 1 : Dans le premier argument, il n’est pas nécessaire d’indiquer une expression de comparaison, car l’argument lui-même est booléen, puisque la propriété « Prop 1 » est de type Checkbox. Par conséquent, l’argument lui-même nous fournit un true ou un false.

Argument 2 : Le deuxième argument évalue si la valeur de la propriété « Prop 2 » dans chaque ligne est supérieure ou égale à 10.

empty(valeur)

Vérifie si l’argument est vide : s’il est vide, renvoie true ; s’il est rempli, false. Renvoie un booléen.

Exemple 1 : empty( "Mundo" ) → false

Exemple 2 : empty( "" ) → true

Argument : L’expression à vérifier, qui peut s’évaluer en n’importe quel type de valeur, par exemple un nombre, une chaîne de texte ou une date.

Notion Funcion empty() — La formule est incluse dans la propriété Ʃ Formule

Exemple 3 : empty(prop("Valor"))

Argument : Évalue si la valeur de la propriété « Valeur » dans chaque ligne est vide ou non. Si la propriété est vide, elle fournit un true, et sinon un false.

equal(valeur, valeur)

Vérifie si les valeurs renvoyées par deux expressions sont égales. Renvoie un boleano.

Exemple 1 : equal( 2, 3 ) → false

Exemple 2 : equal( "rojo", "azul" ) → false

Exemple 3 : equal(3 * 5, 15 ) → true

Exemple 4 : equal( false, not true ) → true

Opérateur équivalent : [expresión] == [expresión]

Argument 1 : L’expression à vérifier, qui peut s’évaluer en tout type de valeur, par exemple un nombre, une chaîne de texte, une date ou un booléen.

Argument 2 : L’expression à vérifier, qui peut s’évaluer en tout type de valeur, par exemple un nombre, une chaîne de texte, une date ou un booléen.

Notion Funcion equal() — La formule est incluse dans la propriété Ʃ Formule

Exemple : equal(prop("Valor 1"), prop("Valor 2"))

Arguments : Évalue si la valeur des propriétés « Valeur 1 » et « Valeur 2 » est identique. Si les deux propriétés sont égales, elle fournit un true, sinon un false.

if(test logique, valeur, valeur)

La fonction if() permet d’effectuer une action si une condition est remplie, ou une autre action si la condition ne l’est pas. En imbriquant les fonctions if() (en les plaçant les unes dans les autres), vous pouvez définir des actions pour de nombreuses conditions. Cette fonction nécessite trois paramètres :

Test logique, qui s’évalue comme verdadero ou falso.
Valeur ou opération à renvoyer si l’opération est verdadero.
Valeur ou opération à renvoyer si l’opération est falso.

Notion funcion if() — La formule est incluse dans la propriété Ʃ Formule

Exemple 1 : if(prop("Valor 1") > prop("Valor 2"), "Es mayor", "Es menor o igual")

Argument 1 : Évalue si la valeur de la propriété « Valeur 1 » est supérieure à la propriété « Valeur 2 ». Ce n’est que si « Valeur 1 » est supérieure à « Valeur 2 » que le résultat du test logique sera true (Vrai).

Argument 2 : Si le test logique donne comme résultat true, le résultat à afficher sera « Est supérieur ».

Argument 3 : Si le test logique donne comme résultat false, le résultat à afficher sera « Est inférieur ou égal ».

Comme cette formule imbriquée est un peu plus complexe, nous allons voir ces exemples dans une nouvelle vidéo explicative.

Fonction if() imbriquée dans Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 2 : if(prop("Valor 1") > prop("Valor 2"), "Es mayor", if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual"))

Argument 2 : Si le test logique donne comme résultat true, le résultat à afficher sera « Est supérieur ».

Argument 3 : Si le test logique donne comme résultat false, comme troisième argument nous incluons un nouveau if(prop("Valor 1") < prop("Valor 2"), "Es menor", "Es igual") imbriqué ; ce if comporte à son tour trois paramètres.

https://vimeo.com/444959749

Cliquez sur le bouton PLAY pour voir la vidéo

Cette fonction permet l’utilisation d’expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici.

larger(valeur, valeur)

Renvoie true (vrai) si le premier argument est plus grand que le second, et false (faux) dans le cas contraire. Nous pouvons évaluer tout type de valeur : textes, nombres, dates ou booléens. Si les valeurs sont égales, elle renverrait false. Les deux paramètres doivent être du même type (nombre, texte, …). Renvoie un booléen.

Fonction larger() de Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 1 : larger("Ac","Ab") → true
Exemple 2 : larger(2,3) → false
Exemple 3 : larger(prop("Fecha 1"),prop("Fecha 2")) → true
Exemple 4 : larger(true, false) → true

Argument 1 : La première expression, qui peut s’évaluer en tout type de valeur, par exemple un nombre, un texte, une date ou un booléen.

Argument 2 : L’expression par rapport à laquelle comparer la première. Son type de valeur doit correspondre au type de valeur de la première expression.

Comment les textes sont-ils évalués avec larger() ? Elle évalue d’abord la lettre la plus à gauche de chaque argument. Dans l’exemple 1, comme la première lettre est « A » dans les deux arguments, elle passe à l’évaluation de la deuxième lettre : dans ce cas, le « c » du premier argument est supérieur au « b » du second, car les lettres ont la valeur de leur ordre dans l’alphabet ; ici, le « c » est en troisième position et est donc supérieur au « b » du second argument. Toute lettre minuscule est supérieure à toute lettre majuscule.

Et les dates ? La date la plus récente est toujours la plus grande.

Les booléens : si c’est true, la valeur est 1, et si c’est false, la valeur est 0. Par conséquent, la valeur true est toujours supérieure à false.

largerEq(valeur, valeur)

Identique à la précédente, à la différence que cette fonction renvoie également true lorsque les arguments sont égaux. Renvoie true (vrai) si le premier argument est supérieur ou égal au second, et false (faux) s’il est inférieur. Nous pouvons évaluer tout type de valeur : textes, nombres, dates ou booléens. Les deux paramètres doivent être du même type (nombre, texte, …). Renvoie un booléen.

Fonction largerEq() de Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 1 : largerEq("Ac","Ab") → true
Exemple 2 : largerEq(2,2) → true
Exemple 3 : largerEq(prop("fecha 1"),prop("fecha 2")) → true
Exemple 4 : largerEq(true, false) → true

Argument 1 : La première expression, qui peut s’évaluer en tout type de valeur, par exemple un nombre, un texte, une date ou un booléen.

Argument 2 : L’expression par rapport à laquelle comparer la première. Son type de valeur doit correspondre au type de valeur de la première expression.

Les booléens : si c’est true, la valeur est 1, et si c’est false, la valeur est 0. Par conséquent, la valeur true est toujours supérieure à false.

not(test logique)

Vérifie si le test logique renvoie false. Si le test logique est false, elle renvoie true, et inversement. Renvoie un booléen.

Exemple 1 : not(2 == 3) → true

Exemple 2 : not(prop("País 1") == prop("País 2"))

Exemple 3 : not prop("País 1") == prop("País 2")

L’exemple 3 fait la même chose que l’exemple 2 : dans Notion, lorsque nous saisissons l’expression sous la forme montrée dans l’exemple 2, une fois que nous appuyons sur le bouton Done, elle est modifiée comme dans l’exemple 3.

Argument 1 : Le test logique évalue un booléen. Dans ce cas, il évalue si 2 == 3 le résultat est false (faux). La fonction renvoie le booléen opposé au résultat du test logique true.

Fonction not() de Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 4 : if (not prop("Finalizado"), "No finalizado", "Finalizado")

Dans cet exemple, nous avons inclus not imbriqué dans une fonction if(). Comme on le voit, cette fonction perd les parenthèses et fonctionne comme un opérateur de négation.

Cette fonction permet l’utilisation d’expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici.

or(test logique, test logique)

Si l’un ou les deux tests logiques renvoient true. Si les deux sont false, elle renvoie false. Renvoie un booléen.

Exemple 1 : or(2==2, 1==3) → true

Exemple 2 : or(2==4, 1==3) → false

Argument 1 : La première expression de comparaison doit évaluer un test logique, donnant comme résultat une valeur booléenne.

Argument 2 : La deuxième expression de comparaison doit évaluer un test logique, donnant comme résultat une valeur booléenne.

Cette fonction permet l’utilisation d’expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici.

smaller(valeur, valeur)

Renvoie true (vrai) si le premier argument est plus petit que le second, et false (faux) dans le cas contraire. Nous pouvons évaluer tout type de valeur : textes, nombres, dates ou booléens. Si les valeurs sont égales, elle renverrait false. Les deux paramètres doivent être du même type (nombre, texte, …). Renvoie un booléen.

Fonction smaller() de Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 1 : smaller( "Ac","Ab") → false
Exemple 2 : smaller( 2, 3 ) → true
Exemple 3 : smaller(prop("Fecha 1"),prop("Fecha 2")) → false
Exemple 4 : smaller( true, false ) → false

Argument 1 : La première expression, qui peut s’évaluer en tout type de valeur, par exemple un nombre, un texte, une date ou un booléen.

Argument 2 : L’expression par rapport à laquelle comparer la première. Son type de valeur doit correspondre au type de valeur de la première expression.

Les booléens : si c’est true, la valeur est 1, et si c’est false, la valeur est 0. Par conséquent, la valeur true est toujours supérieure à false.

smallerEq(valeur, valeur)

Renvoie true (vrai) si le premier argument est plus petit que le second, et false (faux) dans le cas contraire. Nous pouvons évaluer tout type de valeur : textes, nombres, dates ou booléens. Si les valeurs sont égales, elle renverrait true. Les deux paramètres doivent être du même type (nombre, texte, …). Renvoie un booléen.

Fonction smallerEq() de Notion — La formule est incluse dans la propriété Ʃ Formule

Exemple 1 : smallerEq( "Ac","Ab") → false
Exemple 2 : smallerEq( 2, 3 ) → true
Exemple 3 : smallerEq(prop("Fecha 1"),prop("Fecha 2")) → false
Exemple 4 : smallerEq( true, false ) → false

Argument 1 : La première expression, qui peut s’évaluer en tout type de valeur, par exemple un nombre, un texte, une date ou un booléen.

Argument 2 : L’expression par rapport à laquelle comparer la première. Son type de valeur doit correspondre au type de valeur de la première expression.

Les booléens : si c’est true, la valeur est 1, et si c’est false, la valeur est 0. Par conséquent, la valeur true est toujours supérieure à false.

unequal(valeur, valeur)

Vérifie si les valeurs renvoyées par deux expressions sont différentes. Renvoie un booléen.

Exemple 1 : unequal( 2, 3 ) → true

Exemple 2 : unequal( "rojo", "rojo" ) → false

Exemple 3 : unequal(6 * 9, 42 ) → false

Exemple 4 : unequal( true, not false ) → false

Opérateur équivalent : [expresión] != [expresión]

Fonction unequal() de Notion — La formule est incluse dans la propriété Ʃ Formule

Argument 1 : L’expression à vérifier, qui peut s’évaluer en tout type de valeur, par exemple un nombre, une chaîne de texte, une date ou un booléen.

Argument 2 : L’expression à vérifier, qui peut s’évaluer en tout type de valeur, par exemple un nombre, une chaîne de texte, une date ou un booléen.

Fonctions numériques de Notion

Les fonctions numériques effectuent des opérations mathématiques avec des nombres et renvoient toujours un nombre. Vous pouvez voir ci-dessous un tableau avec les opérateurs mathématiques que nous pouvons utiliser pour effectuer ces opérations.

Opérateur	Description	Exemples
`-`	Soustrait l’opérande de droite de l’opérande de gauche pour renvoyer leur différence.	`4 - 2` → `2`
`+`	Additionne des opérandes numériques pour renvoyer leur somme, ou concatène (combine) des opérandes textuels (chaînes de texte).	`2 + 2` → `4`
`*`	Multiplie ses opérandes pour renvoyer leur produit.	`3 * 6` → `18`
`/`	Divise l’opérande de gauche par l’opérande de droite pour renvoyer leur quotient.	`21 / 7` → `3`
`%`	L’opérateur modulo renvoie le reste après avoir divisé l’opérande de gauche par l’opérande de droite.	`23 % 7` → `2`
`^`	Renvoie la valeur de la base élevée à la puissance.	`2 ^ 4` → `16`

abs(nombre)

Renvoie la valeur absolue d’un nombre. Renvoie un nombre.

Exemple 1 : abs( -3 ) → 3

Argument 1 : Le nombre dont nous voulons obtenir la valeur absolue.

add(valeur, valeur)

Additionne deux nombres et renvoie leur somme. Concatène également deux chaînes de caractères et renvoie leur concaténation. Renvoie un nombre ou un texte selon le type de ses arguments.

Exemple 1 : add( 3 , 4 ) → 7

Exemple 2 : add( "Hola " , "mundo" )→ Hola mundo

Argument 1 : Premier nombre ou texte de l’addition ou de la concaténation.

Argument 2 : Deuxième nombre ou texte de l’addition ou de la concaténation.

cbrt(nombre)

Renvoie la racine cubique d’un nombre. Renvoie un nombre.

Exemple 1 : cbrt( 8 ) → 2

Argument 1 : Le nombre dont nous voulons obtenir la racine cubique.

ceil(nombre)

Renvoie le plus petit entier supérieur ou égal à un nombre. Renvoie un nombre.

Exemple 1 : ceil( 4.2 ) → 5

Argument 1 : Le nombre dont nous voulons obtenir l’entier supérieur ou égal le plus proche.

Notion utilise le point comme séparateur décimal.

divide(nombre, nombre)

Divise deux nombres et renvoie leur quotient. Renvoie un nombre.

Exemple 1 : divide( 21, 7 ) → 3

Argument 1 : Dividende.

Argument 1 : Diviseur.

exp(nombre)

Renvoie E ^ x, où x est l’argument et E est la constante d’Euler (2,718…), la base du logarithme naturel. Renvoie un nombre.

Exemple 1 : exp( 2 ) → 7.389056098931

Argument 1 : Le nombre qui servira d’exposant de E.

floor(nombre)

Renvoie le plus grand entier inférieur ou égal à un nombre. Renvoie un nombre.

Exemple 1 : floor( 4.2 ) → 4

Argument 1 : Le nombre dont nous voulons obtenir l’entier inférieur ou égal le plus proche.

Notion utilise le point comme séparateur décimal.

ln(nombre)

Renvoie le logarithme naturel, appelé logarithme népérien, d’un nombre. Renvoie un nombre.

Exemple 1 : ln( 3 ) → 1.098612288668

Argument 1 : Le nombre dont nous voulons obtenir le logarithme népérien.

log10(nombre)

Renvoie le logarithme en base 10 d’un nombre. Renvoie un nombre.

Exemple 1 : log10( 100 ) → 2

Argument 1 : Le nombre dont nous voulons obtenir le logarithme en base 10.

log2(nombre)

Renvoie le logarithme en base 2 d’un nombre. Renvoie un nombre.

Exemple 1 : log2( 8 ) → 3

Argument 1 : Le nombre dont nous voulons obtenir le logarithme en base 2.

max(nombre, nombre, nombre, …)

Renvoie le plus grand nombre d’une liste ; nous pouvons ajouter autant de nombres que nous le souhaitons, séparés par des virgules. Renvoie un nombre.

Exemple 1 : max( 2, 5, 7, 21, 3 ) → 21

Arguments 1, 2, 3, … : Liste de nombres séparés par des virgules.

min(nombre, nombre, nombre, …)

Renvoie le plus petit nombre d’une liste ; nous pouvons ajouter autant de nombres que nous le souhaitons, séparés par des virgules. Renvoie un nombre.

Exemple 1 : min( 2, 5, 7, 21, 3 ) → 2

Arguments 1, 2, 3, … : Liste de nombres séparés par des virgules.

mod(nombre, nombre)

Divise deux nombres et renvoie le reste. Renvoie un nombre.

Exemple 1 : mod( 7, 3 ) → 1

Arguments 1 : Dividende.

Arguments 1 : Diviseur.

multiply(nombre, nombre)

Multiplie deux nombres et renvoie leur produit. Renvoie un nombre.

Exemple 1 : multiply( 2 , 3 ) → 6

Argument 1 : Premier nombre ou facteur de la multiplication.

Argument 2 : Deuxième nombre ou facteur de la multiplication.

pow(nombre, nombre)

Renvoie la base à la puissance de l’exposant. Renvoie un nombre.

Exemple 1 : pow( 2 , 5 ) → 32

Argument 1 : Base.

Argument 2 : Exposant.

round(nombre)

Renvoie la valeur d’un nombre arrondie à l’entier le plus proche. Renvoie un nombre.

Exemple 1 : round( 4.4 ) → 4

Exemple 1 : round( 4.5 ) → 5

Argument 1 : Nombre à arrondir.

sign(nombre)

Renvoie le signe d’un nombre : s’il est positif, renvoie 1 ; s’il est négatif, renvoie -1 ; et s’il est égal à zéro, renvoie 0. Renvoie un nombre.

Exemple 1 : sign( -9 ) → -1

Exemple 1 : sign( 5 ) → 1

Exemple 1 : sign( 0 ) → 0

Argument 1 : Nombre dont nous voulons renvoyer le signe.

sqrt(nombre)

Renvoie la racine carrée d’un nombre. Renvoie un nombre.

Exemple 1 : sqrt( 16 ) → 4

Argument 1 : Nombre dont nous voulons renvoyer la racine carrée.

subtract(nombre, nombre)

Soustrait deux nombres et renvoie leur différence. Renvoie un nombre.

Exemple 1 : subtract( 4 , 3 ) → 1

Argument 1 : Premier nombre, ou minuende de la soustraction.

Argument 2 : Deuxième nombre, ou soustrait de la soustraction.

toNumber(texte)

Convertit un texte en nombre. Si la chaîne de texte commence par un nombre suivi de texte, elle prend ce nombre et le renvoie comme résultat. Renvoie un nombre.

Exemple 1 : toNumber( "7" ) → 7

Exemple 1 : toNumber( "51 productos" ) → 51

Argument 1 : Le nombre à convertir.

unaryMinus(nombre)

Convertit un nombre négatif en positif, ou un nombre positif en négatif. Renvoie un nombre.

Exemple 1 : unaryMinus( -2 ) → 2

Exemple 2 : unaryMinus( 3 ) → -3

Argument 1 : Le nombre à convertir.

Opérateur équivalent : [número] * -1

unaryPlus(texte)

Convertit un texte en nombre. Si la chaîne de texte commence par un nombre suivi de texte, contrairement à toNumber(), elle ne prend pas ce nombre et renvoie le champ vide. Renvoie un nombre.

Exemple 1 : unaryPlus( "7" ) → 7

Exemple 1 : unaryPlus( "51 productos" ) →

Argument 1 : Le texte à convertir.

Fonctions de texte de Notion

Fonctions avec lesquelles vous pourrez effectuer des modifications et des traitements liés aux textes ou aux propriétés contenant des textes.

concat(texte, texte, …)

Concatène ou combine des textes ; il n’y a pas de limite au nombre d’arguments, vous pouvez en inclure autant que vous le souhaitez. Renvoie un texte.

Exemple 1 : concat( "La ","Colmena ", "Tecnológica" ) → "La Colmena Tecnológica"

Arguments : Les textes à concaténer.

contains(texte, texte)

Renvoie true (vrai) si le deuxième argument est trouvé dans le premier. Renvoie un booléen.

Exemple 1 : contains( "notion","ion" ) → true

Exemple 1 : contains( "La Colmena","Tec" ) → false

Argument 1 : Le texte dans lequel nous voulons chercher.

Argument 1 : Le texte à rechercher.

format(valeur)

Convertit un nombre, une date ou un booléen en texte. Renvoie un texte.

Exemple 1 : format( 3 ) → "3"

Argument 1 : Nombre, date ou booléen à convertir.

join(texte, texte, …)

Concatène ou combine des textes avec un délimiteur spécifié. Renvoie un texte.

Exemple 1 : join( ", ","Olga", "María", "Fernando", "Luisa" ) → "Olga, María, Fernando, Luisa"

Arguments : Le premier argument est le délimiteur, une chaîne de texte. Les arguments restants sont les textes qui seront combinés, séparés par le délimiteur. Nous pouvons inclure autant d’arguments que nous le souhaitons.

length(texte, expression, texte)

Renvoie le nombre de caractères dans une chaîne de texte. Renvoie un texte.

Exemple 1 : length( "La Colmena Tecnológica" ) → 22

Argument 1 : Le texte dont nous voulons renvoyer la longueur.

replace(texte, expression, texte)

Remplace la première correspondance d’une expression régulière dans une chaîne de texte par un nouveau texte spécifié. Renvoie une chaîne de texte.

Exemple 1 : replace( "La verdad", "La", "Es" ) → "Es verdad"

Exemple 2 : replace("1-2-3", "-", "!") → "1!2-3"

Exemple 3 : replace("Mi nombre es Isabel", "(?<=es ).+(?=.)", "María") → "Mi nombre es María"

Argument 1 : Le texte original.

Argument 2 : Texte ou expression régulière (entre guillemets).

Argument 3 : Le texte de remplacement.

L’exemple 3 utilise des expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici

replaceAll(texte, expression, texte)

Remplace la première correspondance d’une expression régulière dans une chaîne de texte par un nouveau texte spécifié. Renvoie une chaîne de texte.

Exemple 1 : replaceAll( "Me gusta el verano. Me gusta nadar", "Me gusta", "Me encanta" ) → "Me encanta el verano. Me encanta nadar."

Exemple 2 : replaceAll(prop("Nombre"), "Dra?. ", "") → Sustituye "Dr. " o "Dra. " que hubiera cualquier registro de la tabla por nada "", es decir los elimina.

Argument 1 : Le texte original.

Argument 2 : Texte ou expression régulière (entre guillemets).

Argument 3 : Le texte de remplacement.

L’exemple 3 utilise des expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici

slice(texte, nombre, nombre)

La fonction slice() renvoie un segment ou une partie du texte que nous lui avons fourni. Cette fonction nécessite au moins deux paramètres, bien que nous puissions en utiliser trois en option :

Texte original dont nous allons extraire une partie.
Point de départ, où le premier caractère est 0.
Point de fin (facultatif)

Exemple 1 : slice("La Colmena Tecnológica.", 3, 10) → « Colmena »

Exemple 2 : slice("La Colmena Tecnológica.", 11, 22) → « Tecnológica »

Les espaces comptent également comme un caractère. Le paramètre de point de fin, contrairement au point de départ, n’inclut pas le caractère ; c’est pourquoi, pour inclure le caractère final, nous devons indiquer la position juste après celui-ci.

test(test)

Vérifie si une chaîne de texte correspond à une expression régulière. Renvoie un booléen.

Exemple 1 : test( "Rojo, Verde, Azul", "Verde" ) → true

Exemple 2 : test(prop("Nombre"), "^A|^C") → Devuelve true para cualquier nombre que empiece por A o por C.

Argument 1 : Le texte original.

Argument 2 : Texte ou expression régulière (entre guillemets).

Argument 3 : Le texte de remplacement.

L’exemple 3 utilise des expressions régulières ; si vous souhaitez apprendre à les utiliser, cliquez ici

Fonctions Date et heure de Notion

Ce sont des fonctions qui nous aident à effectuer des opérations avec des propriétés de type date et heure. Par exemple, calculer combien de jours se sont écoulés entre deux dates, extraire une seule donnée d’une date (jour, mois, année) et bien plus encore. Nous allons découvrir chacune de ces fonctions.

date(date)

Renvoie le jour du mois, un entier compris entre 1 et 31, pour une date donnée. Renvoie un nombre.

Exemple 1 : date(now()) → [current_date format="d"]

Exemple 2 : date(prop("Fecha")) → Devuelve día que tenga la fecha de la propiedad Fecha.

Argument 1 : La date à partir de laquelle identifier le jour du mois.

Notion ne permet d’obtenir une date qu’à travers une propriété de type Date (date et heure) ou à travers la fonction now() qui renvoie la date et l’heure actuelles.

dateAdd(date, nombre, texte)

Ajouter du temps à une date. Le dernier argument peut être l’un des suivants : "years" (années), "quarters" (trimestres), "months" (mois), "weeks" (semaines), "days" (jours), "hours" (heures), "minutes" (minutes), "seconds" (secondes), ou "miliseconds" (millisecondes). Renvoie une date.

Exemple 1 : dateAdd(now(), 1, "months") → Supposons qu’aujourd’hui nous sommes le 15/08/2021, le résultat est Sep 15, 2020 10:46 AM (ce résultat peut être formaté avec la fonction formatDate().

Argument 1 : La date initiale.

Argument 2 : La quantité à ajouter.

Argument 3 : L’unité de temps, qui peut être années, trimestres, mois, semaines, jours, heures, minutes, secondes, millisecondes, entre guillemets.

Notion ne permet d’obtenir une date qu’à travers une propriété de type Date (date et heure) ou à travers la fonction now() qui renvoie la date et l’heure actuelles.

dateBetween(date, date, texte)

Renvoie la durée entre deux dates. Le dernier argument peut être l’un des suivants : "years" (années), "quarters" (trimestres), "months" (mois), "weeks" (semaines), "days" (jours), "hours" (heures), "minutes" (minutes), "seconds" (secondes), ou "miliseconds" (millisecondes). Renvoie un nombre.

Exemple 1 : dateBetween(now(), prop("Created time"), "minutes") → 43

Argument 1 : La date la plus grande.

Argument 2 : La date la plus petite.

Argument 3 : L’unité de temps, qui peut être années, trimestres, mois, semaines, jours, heures, minutes, secondes, millisecondes, entre guillemets.

Notion ne permet d’obtenir une date qu’à travers une propriété de type Date (date et heure) ou à travers la fonction now() qui renvoie la date et l’heure actuelles.

dateSubtract(date, nombre, texte)

Soustraire du temps à une date. Le dernier argument, qui peut être l’un des suivants : "years" (années), "quarters" (trimestres), "months" (mois), "weeks" (semaines), "days" (jours), "hours" (heures), "minutes" (minutes), "seconds" (secondes), ou "miliseconds" (millisecondes). Renvoie une date.

Exemple 1 : dateSubtract(now(), 1, "years") → Supposons qu’aujourd’hui est le 15/08/2021, le résultat est Aug 15, 2020 11:45 AM (ce résultat peut être formaté avec la fonction formatDate()).

Argument 1 : La date initiale.

Argument 2 : La quantité à soustraire.

Argument 3 : L’unité de temps, qui peut être années, trimestres, mois, semaines, jours, heures, minutes, secondes, millisecondes, entre guillemets.

Notion ne permet d’obtenir une date qu’à travers une propriété de type Date (date et heure) ou à travers la fonction now() qui renvoie la date et l’heure actuelles.

day(date)

Renvoie l’indice (numéro) du jour de la semaine pour une date, où le dimanche est 0, le lundi 1, et ainsi de suite. Renvoie un nombre.

Exemple 1 : day(now()) → [current_date format="w"]

Argument 1 : La date pour laquelle identifier le jour de la semaine.

Notion ne permet d’obtenir une date qu’à travers une propriété de type Date (date et heure) ou à travers la fonction now() qui renvoie la date et l’heure actuelles.

end(date)

Renvoie la date de fin d’une propriété de date qui contient une plage de dates. Renvoie une date.

Exemple 1 : end(prop("Duración")) → Jun 27, 2020 21:15 AM (ce résultat peut être formaté avec la fonction formatDate()).

Argument 1 : Une référence à une propriété de type Date qui contient une date de fin.

formatDate(date, texte)

Formate une date avec la chaîne de format de temps standard de Moment.

Exemple 1 : formatDate(now(),"DD/MM/YYYY") → [current_date format="d/m/Y"]

Argument 1 : La propriété date ou now() que nous voulons formater.

Argument 2 : Format de temps standard de Moment entre guillemets.

Formats de date

Combinez ces motifs pour construire le second argument de la fonction.

Catégorie	Motif	Représentation
Année	`YY` `YYYY`	[current_date format=»y»] [current_date format=»Y»]
Trimestre	`Q` `Qo`	1 … 4 1er … 4e
Mois	`M` `Mo` `MM` `MMM` `MMMM`	1 … 12 1er … 12e 01 … 12 juin janvier
Semaine de l’année	`w` `wo` `ww`	1 … 53 1re … 53e 01 … 53
Jour de l’année	`DDD` `DDDo` `DDDD`	1 … 365 1er … 365e 001 … 365
Jour	`D` `Do` `DD`	1 … 31 1er … 31e 01 … 31
Jour de la semaine	`d` `dd` `ddd` `dddd`	0 … 6 Di Dim Dimanche
24 heures	`H` `HH`	0 … 23 00 … 23
12 heures	`h` `hh`	1 … 12 01 … 12
Minutes	`m mm`	0 … 59 00 … 59
Secondes	`s` `ss`	0 … 59 00 … 59
AM / PM	`a` `A`	a.m A.M
Décalage de fuseau horaire	`Z` `ZZ`	+02:00 +0200
Secondes précises	`S` `SS`	0 … 9 00 … 99
Millisecondes	`SSS`	000 … 999
Horodatage Unix	`X`	1597491300
Horodatage Unix en millisecondes	`x`	1597491300000

fromTimestamp(nombre)

Renvoie une valeur de date à partir d’un horodatage Unix en millisecondes, ou du nombre de millisecondes depuis le 1er janvier 1970. Renvoie une date.

Exemple 1 : fromTimestamp(159749388000) → Aug 15, 2020 14:19 AM (ce résultat peut être formaté avec la fonction formatDate()).

Argument 1 : Nombre d’un horodatage Unix en millisecondes, ou nombre de millisecondes écoulées depuis le 1er janvier 1970.

hour(date)

Renvoie l’heure du jour, un nombre entier entre 0 et 23 d’une date. Renvoie un nombre.

Exemple 1 : hour(now()) → [current_date format="G"]

Argument 1 : La valeur date/heure dont nous voulons obtenir l’heure du jour.

minute(date)

Renvoie la minute de l’heure, un nombre entier entre 0 et 59 d’une date. Renvoie un nombre.

Exemple 1 : minute(now()) → [current_date format="i"]

Argument 1 : La valeur date/heure dont nous voulons obtenir la minute.

month(date)

Renvoie l’indice numérique du mois de l’année, un nombre entier entre 0 et 11 d’une date, où janvier est 0, février est 1, … Renvoie un nombre.

Exemple 1 : month(now()) → 7

Argument 1 : La date dont nous voulons obtenir l’indice numérique du mois de l’année.

now()

Renvoie la date actuelle. Renvoie une date.

Exemple 1 : now() → Aug 15, 2021 14:34 PM

Arguments : Cette fonction ne prend pas d’arguments.

start(date)

Renvoie la date de début d’une propriété de date qui contient une plage de dates. Renvoie une date.

Exemple 1 : start(prop("Duración")) → Jun 01, 2020 21:15 AM (ce résultat peut être formaté avec la fonction formatDate()).

Argument 1 : Une référence à une propriété de type Date qui contient une date de début.

timestamp(date)

Renvoie l’horodatage Unix en millisecondes, ou le nombre de millisecondes depuis le 1er janvier 1970 de la date donnée. Renvoie une date.

Exemple 1 : timestamp(now()) → 159749388000

Argument 1 : La date dont nous voulons obtenir l’horodatage.

year(date)

Renvoie l’année d’une date. Renvoie un nombre.

Exemple 1 : year(now()) → [current_date format="Y"]

Argument 1 : La date dont nous voulons obtenir l’année.

Constantes

Ce sont des valeurs fixes qui ne peuvent être ni altérées ni modifiées, elles ne peuvent qu’être lues. Nous pouvons les utiliser dans les formules :

Constante	Description	Valeur
`e`	La base du logarithme naturel ou népérien.	`2.718281828459`
`false`	Faux ou `0`	`false`
`true`	Vrai ou `1`	`true`
`pi`	Le rapport entre la circonférence d’un cercle et son diamètre	`3.14159265359`