Syntaxe et fonctions des formules

Titre

prop("Titre")prop("Titre").length()

Texte

Texte

prop("Texte")prop("Texte").length()

Texte

Sélection

prop("Priorité") == "High"

Texte

Sélection multiple

prop("Étiquettes").length()prop("Étiquettes").includes("Finance")

Texte

Case à cocher

prop("Case à cocher")
not prop("Case à cocher")

Booléen

E-mail, URL, numéro de téléphone

!empty(prop("Téléphone"))
!empty(prop("E-mail"))
link("Appeler", "tel :" + prop("Téléphone")

Texte

Identifiant unique

prop("Identifiant tâche").split("-").first()← Préfixe
prop("Identifiant tâche").split("-").last() ← Identifiant (ID)

Texte

Créé par,
Modifié par

prop("Créé par").name()
prop("Créé par").email()

Personne

Personne

prop("Personne")
prop("Personne").at(0).name()
prop("Personne").map(current.email())

Personne

Date,
Date de création,
Dernière modification

prop("Date d'échéance") > now()
dateBetween(prop("Anniversaire"), now(), "days")

Date

Nombre

prop("Nombre") / 2
pi() * prop("Rayon") ^ 2

Nombre

Relation

prop("Tâches").length()
prop("Tâches").filter(current.prop("État") !== "Terminé")

Page

Agrégation

prop("Achats").length()
prop("Coût moyen") * 12

Nombre, date ou tout type de liste. Le type dépend de la configuration de l’agrégation.

Opérateurs mathématiques :+, -, *, %

2 * pi())
"hello" + "world"

Valeurs booléennes :
true, false

truefalse

Opérateurs de comparaison :
==, >, >=, <, <=

123 == 123 = true"Notion" == "Motion" = false

Opérateurs logiques :
and, or, not

and:
true and false
true && falseand(true, false)
or:
true or false
true || falseor(true, false)
not:
not true
!true

Opérateur ternaire :
? :

X ? Y : Z équivaut à if(X, Y, Z)

Renvoie la première valeur si la condition est vérifiée, et la deuxième valeur dans les autres cas.

if(true, 1, 2) = 1if(false, 1, 2) = 2prop("Cochée") == true ? "Complete" : "Incomplete"

Renvoie la valeur qui correspond à la première condition vérifiée. Cet opérateur peut être utilisé pour remplacer plusieurs instructions if() imbriquées.

ifs(true, 1, true, 2, 3) = 1ifs(false, 1, false, 2, 3) = 3

Renvoie « true » si la valeur est vide. 0, “” et [] sont considérés comme vides.

empty(0) = trueempty([]) = true

Renvoie la valeur de la longueur du texte ou de la liste.

length("hello") = 5length([1, 2, 3]) = 3

Renvoie la partie du texte comprise entre l’index de départ (inclus) et l’index de fin (facultatif, exclus).

substring("Notion", 0, 3) = "Not"substring("Notion", 3) = "ion"

Renvoie « true » si la chaîne de caractères est contenue dans la valeur.

contains("Notion", "ot") = true

Renvoie « true » si la valeur correspond à l’expression régulière, et « false » dans le cas contraire.

test("Notion", "Not") = truetest("Notion", "\\d") = false

Renvoie toutes les valeurs correspondant à l’expression régulière sous forme de liste.

match("Notion Notion", "Not") = ["Not", "Not"]match("Notion 123 Notion 456", "\\d+") = ["123", "456"]

Remplace la première correspondance de l’expression régulière par la valeur de remplacement.

replace("Notion Notion", "N", "M") = "Motion Notion"

Remplace toutes les correspondances de l’expression régulière par la valeur de remplacement.

replaceAll("Notion Notion", "N", "M") = "Motion Motion"replaceAll("Notion 123", "\\d", "") = "Notion"

Convertit le texte en minuscules.

lower("NOTION") = "notion"

Convertit le texte en majuscules.

upper("notion") = "NOTION"

Répète le texte un nombre donné de fois.

repeat("0", 4) = "0000"repeat("~=", 10) = "~=~=~=~=~=~=~=~=~=~="

Crée un lien hypertexte en associant du texte et un lien URL.

link("Notion", "https://notion.so") = "Notion"

Ajoute des styles et des couleurs au texte. Styles de mise en forme pris en charge : "b" (gras), "u" (souligné), "i" (italique), "c" (code), ou "s" (barré). Couleurs prises en charge : "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", et "red". Ajoutez "_background" aux couleurs pour définir des couleurs de fond.

style("Notion", "b", "u") = "Notion"style("Notion", "blue", "gray_background")

Supprime des styles de mise en forme du texte. Si aucun style n’est spécifié, tous sont supprimés.

unstyle("Texte")unstyle("Texte", "b")

Renvoie la valeur sous forme de texte.

format(1234) = "1234"format(now()) = "August 30, 2023 17:55"

Renvoie la somme de deux nombres.

add(5, 10) = 155 + 10 = 15

Renvoie la différence entre deux nombres.

subtract(5, 10) = -55 - 10 = -5

Renvoie le produit de deux nombres.

multiply(5, 10) = 505 * 10 = 50

Renvoie le reste de la division euclidienne du premier nombre par le second (le modulo du deuxième nombre par le premier).

mod(5, 10) = 55 % 10 = 5

Renvoie le résultat du premier nombre élevé à la puissance du deuxième nombre en exposant.

pow(5, 10) = 97656255 ^ 10 = 9765625

Renvoie le quotient du premier nombre par le deuxième.

divide(5, 10) = 0.55 / 10 = 0.5

Renvoie le plus petit des arguments.

min(1, 2, 3) = 1min([1, 2, 3]) = 1

Renvoie le plus grand des arguments.

max(1, 2, 3) = 3max([1, 2, 3]) = 3

Renvoie la somme de ses arguments.

sum(1, 2, 3) = 6sum([1, 2, 3], 4, 5) = 15

Renvoie la valeur absolue du nombre.

abs(10) = 10abs(-10) = 10

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

round(0.4) = 0round(-0.6) = -1

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

ceil(0.4) = 1ceil(-0.6) = 0

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

floor(0.4) = 0floor(-0.6) = -1

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

sqrt(4) = 2sqrt(7) = 2.6457513110645907

Renvoie la racine cubique du nombre.

cbrt(9) = 2.080083823051904cbrt(64) = 4

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

exp(1) = 2.718281828459045exp(-1) = 0.36787944117144233

Renvoie le logarithme naturel d’un nombre.

ln(2.718281828459045) = 1ln(10) = 2.302585092994046

Renvoie le logarithme décimal du nombre (base 10).

log10(10) = 1log10(100000) = 5

Renvoie le logarithme binaire du nombre (base 2).

log2(4) = 2log2(1024) = 10

Renvoie 1 si le nombre est positif, -1 s’il est négatif et 0 s’il est nul.

sign(-10) = -1sign(10) = 1

Renvoie le rapport de la circonférence d’un cercle à son diamètre.

pi() = 3.141592653589793

Renvoie la base du logarithme naturel.

e() = 2.718281828459045

Identifie un nombre dans un texte.

toNumber("2") = 2toNumber(now()) = 1693443300000toNumber(true) = 1

Renvoie la date et l’heure actuelles.

now() = @30 août 2023 17:55

Renvoie la minute de la date (0-59).

minute(parseDate("2023-07-10T17:35Z")) = 35

Renvoie l’heure de la date (0-23).

hour(parseDate("2023-07-10T17:35Z")) = 17

Renvoie le jour de la semaine de la date, une valeur comprise entre 1 (lundi) et 7 (dimanche).

day(parseDate("2023-07-10T17:35Z")) = 1

Renvoie le jour du mois de la date (1-31).

date(parseDate("2023-07-10T17:35Z")) = 10

Renvoie la semaine ISO de l’année de la date (1-53).

week(parseDate("2023-01-02")) = 1

Renvoie le mois de la date (1-12).

month(parseDate("2023-07-10T17:35Z")) = 7

Renvoie l’année de la date.

year(now()) = 2023

Ajoute l'heure à la date. L’argument de l’unité peut être "years", "quarters", "months", "weeks", "days", "hours", ou "minutes".

dateAdd(now(), 1, "days") = @31 août 2023 17:55dateAdd(now(), 2, "months") = @30 octobre 2023 17:55dateAdd(now(), 3, "years") = @30 août 2026 17:55

Soustrait l'heure de la date. L’argument de l’unité peut être "years", "quarters", "months", "weeks", "days", "hours", ou "minutes".

dateSubtract(now(), 1, "days") = @29 août 2023 17:55dateSubtract(now(), 2, "months") = @30 juin 30 2023 17:55dateSubtract(now(), 3, "years") = @30 août 2020 17:55

Renvoie la différence entre deux dates. L’argument de l’unité peut être "years", "quarters", "months", "weeks", "days", "hours", ou "minutes".

dateBetween(now(), parseDate("2022-09-07"), "days") = 357dateBetween(parseDate("2030-01-01"), now(), "years") = 6

Renvoie un intervalle de temps défini à partir des dates de début et de fin.

dateRange(prop("Date de début"), prop("Date de fin")) = @7 septembre 2022 → 7 septembre 2023

Renvoie le début de l’intervalle de temps.

dateStart(prop("Intervalle de temps")) = @7 septembre 2022dateBetween(dateStart(prop("Intervalle de temps")), dateEnd(prop("Intervalle de temps")), "days") = -365

Renvoie la fin de l’intervalle de temps.

dateEnd(prop("Intervalle de temps")) = @7 septembre 2023dateBetween(dateEnd(prop("Intervalle de temps")), dateStart(prop("Intervalle de temps")), "days") = 365

Renvoie l’horodatage Unix actuel, représentant le nombre de millisecondes qui se sont écoulées depuis le 1er janvier 1970.

timestamp(now()) = 1693443300000

Renvoie la date à partir de l’horodatage Unix donné. L’horodatage représente le nombre de millisecondes qui se sont écoulées depuis le 1er janvier 1970. Note : la date et l’heure renvoyées n’afficheront pas les secondes et les millisecondes.

fromTimestamp(1689024900000) = @10 juillet 2023 14:35

Affiche une date selon un format personnalisé. Le format final peut contenir les éléments suivants pour représenter les parties de la date : "YYYY" pour l’année, "MM" pour le mois, "DD" pour le jour, "h" pour l’heure et "mm" pour les minutes.

formatDate(now(), "D MMMM Y") = "30 août 2023"
formatDate(now(), "DD/MM/YYYY") = "30/08/2023"
formatDate(now(), "h:mm") = "17:55"

Renvoie la date au format de la norme ISO 8601.

parseDate("2022-01-01") = @1 janvier 2022parseDate("2022-01-01T00:00Z") = @31 décembre 2021 16:00

Renvoie le nom d’une personne.

name(prop("Créé par"))prop("Visionnaires").map(name(current)).join(", ") = "Grace Hopper, Ada Lovelace"

Renvoie l’adresse e-mail d’une personne.

email(prop("Créé par"))prop("Personne").map(email(current)).join(", ")

Renvoie la valeur à l’index spécifié dans une liste.

at([1, 2, 3], 1) = 2

Renvoie le premier élément de la liste.

first([1, 2, 3]) = 1

Renvoie le dernier élément de la liste.

last([1, 2, 3]) = 3

Renvoie les éléments de la liste compris entre l’index de départ fourni (inclus) jusqu’à l’index de fin (facultatif et exclus).

slice([1, 2, 3], 1, 2) = [2]slice(["a", "b", "c"], 1) = ["b", "c"]

Renvoie la concaténation de plusieurs listes.

concat([1, 2], [3, 4]) = [1, 2, 3, 4]concat(["a", "b"], ["c", "d"]) = ["a", "b", "c", "d"]

Renvoie la liste triée dans l’ordre spécifié.

sort([3, 1, 2]) = [1, 2, 3]

Renvoie la liste dans l’ordre inverse.

reverse(["green", "eggs", "ham"]) = ["ham", "eggs", "green"]

Renvoie les valeurs de la liste avec un caractère de jointure entre chacune des valeurs.

join(["a", "b", "c"], ", ") = "a, b, c"join(["dog", "go"], "") = "doggo"

Renvoie la liste de valeurs créée en séparant le texte avec un caractère spécifié.

split("apple,pear,orange", ",") = ["apple", "pear", "orange"]

Renvoie la liste des valeurs en supprimant toutes les valeurs dupliquées.

unique([1, 1, 2]) = [1, 2]

Renvoie « true » si la liste contient la valeur spécifiée, et « false » dans le cas contraire.

includes(["a", "b", "c"], "b") = trueincludes([1, 2, 3], 4) = false

Renvoie le premier élément de la liste pour lequel la condition est vérifiée.

find(["a", "b", "c"], current == "b") = "b"find([1, 2, 3], current > 100) = Empty

Renvoie l’index du premier élément de la liste pour lequel la condition est vérifiée.

findIndex(["a", "b", "c"], current == "b") = 1findIndex([1, 2, 3], current > 100) = -1

Renvoie les valeurs de la liste pour lesquelles la condition est vérifiée.

filter([1, 2, 3], current > 1) = [2, 3]filter(["a", "b", "c"], current == "a") = ["a"]

Renvoie la valeur « true » si l’un des éléments de la liste vérifie la condition donnée, et « false » dans le cas contraire.

some([1, 2, 3], current == 2) = truesome(["a", "b", "c"], current.length > 2) = false

Renvoie la valeur « true » si tous les éléments de la liste vérifient la condition donnée, et « false » dans le cas contraire.

every([1, 2, 3], current > 0) = trueevery(["a", "b", "c"], current == "b") = false

Renvoie la liste créée à partir des résultats de l’appel de l’expression sur chaque élément de la liste d’entrée.

map([1, 2, 3], current + 1) = [2, 3, 4]map([1, 2, 3], current + index) = [1, 3, 5]

Convertit une liste de listes en une seule liste.

flat([1, 2, 3]) = [1, 2, 3]flat([[1, 2], [3, 4]]) = [1, 2, 3, 4]

Renvoie l’identifiant de la page. Si aucune page n'est fournie, renvoie l'identifiant de la page sur laquelle se trouve la formule.

id()
id(prop("Relation").first())

Renvoie « true » si les deux valeurs sont égales, et « false » dans le cas contraire.

equal(1, 1) = true"a" == "b" = false

Renvoie « false » si les deux valeurs sont égales, et « true » dans le cas contraire.

unequal(1, 2) = true"a" != "a" = false

Affecte une valeur à une variable et calcule l’expression avec cette variable.

let(personne, "Guenièvre", "Bonjour, " + person + " !") = "Bonjour, Guenièvre !"let(rayon, 4, round(pi() * rayon ^ 2)) = 50

Affecte des valeurs à plusieurs variables et calcule l'expression avec ces variables.

lets(a, "Hello", b, "world", a + " " + b) = "Hello world"lets(base, 3, height, 8, base * height / 2) = 12