Ksaar documentation
Se connecter
  • 👋Bienvenue sur Ksaar !
  • 👾Les concepts de base
    • ✨Créer une App
    • ✋L'Espace Personnel
    • 🎨Éditer le contenu
  • LES ÉLÉMENTS
    • 🔠Les éléments
    • 🧑‍🎨 Éléments contenus basiques
    • ✔️ Éléments champs
    • { } Les Variables
    • 📈Éléments données
    • 🖇️Éléments liaisons
      • ↔️Liaison synchronisée
    • ⏭️Éléments matrices
    • 💯Les Calculs
      • 📆Calculs sur des dates
      • 🔢Calculs conditionnels
      • 🔗Calculs de liaison
    • ➗Les Formules
  • Les workflows
    • 🗂️Le Workflow
      • 🚀Workflow public
    • 📋Les Pages
    • 💥Les Actions
      • ✉️Envoi d'e-mails et de SMS
      • 🧭Redirection
      • 📄Créer un document
      • ⏭️Exporter une fiche
      • 🔄Mettre à jour les champs et liaisons
      • 💱Convertir des fichiers
      • 🚻Créer un groupe
      • 👯‍♂️Ajouter au(x) groupe(s)
      • 📝Signature électronique
      • ☎️Call API
      • 🧠Ksaar AI
      • 🔃Boucle
      • ⏺️Créer un enregistrement
      • 🗑️Supprimer un enregistrement
      • ✔️Activer un utilisateur
      • 🚫Désactiver un utilisateur
      • 📲Créer un QR code
      • 👤Créer un utilisateur
      • ⏺️Sauvegarder l'enregistrement
      • 🗓️Créer un ICS
    • ⬆️Importer des données
    • ⬇️Exporter des données
    • 👀Les Suivis
    • 📑Les fiches : Modifier/afficher vos données
    • ⚙️Les tables
  • Les utilisateurs
    • 🤵‍♀️Créer un Persona
    • 🤵‍♂️Éditer un Persona
    • 👥Groupes
    • 👤Utilisateurs
    • ➕Ajouter un utilisateur
    • 🔐Délégation de l'administration
  • L'affichage des données
    • 👀Visualiser les données
    • 🔲Tableaux
    • 🗓️Plannings
    • ⬜Kanban
    • 📉Dataviz
    • ⚫Listes
    • 📍Cartes
    • 📆Planning de ressources
    • 🕙Planning de réservation de créneaux
  • Design
    • 🔡Customisation des polices
  • 🎨Gestion des styles d'une application
  • Le multi-environnement
    • 🌳Le multi-environnement
      • 🤓L'essentiel du multi-environnement
      • ⏯️Utiliser le multi-environnement
      • 📤Mettre en production
      • 🕑L'historique de versions
  • ALLER PLUS LOIN
    • 🔗Les Liaisons
    • ☝️Les Conditions
    • 🎬Les Scénarios Conditionnels
    • 🪆Les Poupées Russes
    • 🚀Les Automations
      • ⏺️Quand un enregistrement est créé
      • 💱Quand un enregistrement est modifié
      • ⏱️À une date prévue
      • 🌐Quand un webhook est reçu
      • 📩Quand un e-mail est reçu
    • 🔎Vérifier si un enregistrement est déjà existant
    • 📱Créer une app iOS
    • 💾Sauvegarder ses données
  • CONNEXIONS
    • 📧Connexion à un serveur SMTP
      • Paramétrer un SMTP Google / Gmail
      • Paramétrer un SMTP Outlook
    • 🌐API Ksaar
    • 🧰Make
      • 📥Remplir un Google Sheets avec des enregistrements Ksaar
      • 🗓️Synchroniser un agenda Google avec des enregistrements Ksaar
    • 🤖Zapier
  • EN SAVOIR PLUS
    • 📗Le dico Ksaar
    • ❓FAQ
Propulsé par GitBook
Sur cette page
  • ⬅️ Type de retour
  • 🛑 Gestion des erreurs
  • ≠ Différence avec les formules de texte
  • 🔗 🔗 Liaisons multiples dans les formules
  • 🚧 Cas d’usage : Liaisons Calculées
  • 📖 Fonctions disponibles dans les formules

Cet article vous a-t-il été utile ?

  1. LES ÉLÉMENTS

Les Formules

PrécédentCalculs de liaisonSuivantLe Workflow

Dernière mise à jour il y a 1 mois

Cet article vous a-t-il été utile ?

Une formule est une expression qui effectue des calculs sur des valeurs dans votre base de données. Elle peut être aussi simple que l'addition de deux nombres ou aussi complexe que la transformation de plusieurs champs de données selon des critères spécifiques.

La création d'une formule se fait depuis une page d'un Workflow ou d'un Suivi. Cela peut aussi se faire directement dans une table depuis la vue Data.

⬅️ Type de retour

Chaque formule a un type de retour, par exemple la formule UPPER("hello") renvoie un texte, et peut alors être utilisée partout où ce type le permet, que ce soit dans les filtres, les conditions ou dans des mises à jour de champs.

Vous devez choisir le type de retour la première fois que vous éditez votre formule et vous ne pourrez plus le changer par la suite.

Voici la liste exhaustive des types de retour pouvant être utilisés :

  • 🔤 Texte

  • 🔢 Nombre

  • 📆 Date & Date et heure

  • 🗓️ Plage de dates & Plages de dates avec heure

  • 🎨 Couleur

  • ⚖️ Booléen

  • 🧾 JSON

  • 📧 Email

  • Les retours de type “liaisons calculées” doivent retourner un identifiant, sélectionnable depuis les métadonnées :

    • 🔗 Liaison simple

    • 🔗🔗 Liaisons multiples

    • 🙏 Liaison utilisateur

À noter que pour les types de retour liaison simple et liaisons multiples, il vous sera demandé de spécifier la table liée à la formule ainsi que le champ à afficher dans la vue Data

🛑 Gestion des erreurs

  • Vérification de la syntaxe : L'éditeur des formules s'assure de la justesse syntaxique de votre expression. Si la formule est incorrecte, comme dans le cas d'une parenthèse manquante, cela vous sera signalé et elle ne sera pas sauvegardée.

  • Erreurs à l'exécution : Si une formule génère une erreur lors de son exécution (par exemple si on a 2 ^ "hello"), elle retournera une valeur nulle et sera traitée de cette manière.

≠ Différence avec les formules de texte

Contrairement aux formules de texte, les formules permettent de manipuler tout type de champs, il est alors nécessaire de placer les variables dans des fonctions ou d'utiliser des opérateurs.

Par exemple, Utilisateur : {Prénom} {Nom} dans une formule de texte devient "Utilisateur : " & {Prénom} & " " & {Nom} dans une formule.

🔗 🔗 Liaisons multiples dans les formules

Il est possible d'utiliser un champ issu d'une liaison multiple dans les formules. En passant par une liaisons multiple, on obtient la liste des valeurs des enregistrements liés pour le champ choisi, qui peut être manipulé avec les fonctions sur les listes.

Par exemple, {Liaisons multiples -> Nombre} peut donner [5,2,3,2,4] s'il y a 5 enregistrements dans la liaison, avec ces valeurs pour le champ Nombre. Donc SUM({Liaisons multiples -> Nombre}) donne ici 16, la somme des nombres des enregistrements qui sont dans cette liaison multiple.

Depuis une liaison multiple, il n’est pas possible d’aller sélectionner des variables au delà du premier niveau de liaison

🚧 Cas d’usage : Liaisons Calculées

Une table Élève contient une liaison simple vers les enregistrements d’une table Classe. Cette table Classe contient une liaison simple vers une table Niveau.

On voudrait conditionner l’affichage d’une ligne en fonction du Niveau auquel les enregistrements de notre table Élève appartiennent.

Pour ce faire, on ajoute un champ Formule de type Liaison Simple dans la table Élève. Cette formule passe par les deux niveaux de liaisons et vient récupérer l’identifiant de l’enregistrement lié :

On lie donc notre formule à la table Niveau et le champ à afficher au nom du Niveau.

Dans les conditions d’affichage de la ligne, il est maintenant possible d’aller chercher le nom du Niveau de l’enregistrement en cours de la table Élève.

📖 Fonctions disponibles dans les formules

Les opérateurs

Opération
Description

{A} & {B}

Concaténation

{A} + {B}

Addition

{A} - {B}

Soustraction

{A} * {B}

Multiplication

{A} / {B}

Division

{A} % {B}

Modulo

{A} ^ {B}

Puissance

{A} = {B}, {A} == {B} ou {A} === {B}

Égalité

{A} != {B}, {A} !== {B} ou {A} <> {B}

Différence

{A} > {B}

Supérieur

{A} >= {B}

Supérieur ou égal

{A} < {B}

Inférieur

{A} <= {B}

Inférieur ou égal

{A} && {B}

Et

{A} || {B}

Ou

!{A}

Inverse

(paramètres) => (expression)

Lambda

Fonctions de texte

CHAR

Résumé

La fonction CHAR renvoie le caractère correspondant à un code numérique donné.

Syntaxe

  • CHAR(code)

Exemple

  • CHAR(65) → A

CODE

Résumé

La fonction CODE renvoie le code numérique d'un caractère donné.

Syntaxe

  • CODE(caractère)

Exemple

  • CODE("A") → 65

CONCATENATE

Résumé

La fonction CONCATENATE ou & concatène (fusionne) plusieurs chaînes de caractères en une seule.

Syntaxe

  • CONCATENATE(texte1, [texte2, ...])

  • texte1 & texte2

Exemple

  • CONCATENATE("Hello", " ", "world") → Hello world

  • "Hello" & " " & "world" → Hello world

DECODE_URL

Résumé

La fonction DECODE_URL décode une URL encodée pour la rendre lisible.

Syntaxe

  • DECODE_URL(urlEncodé)

Exemple

  • DECODE_URL("Hello%20world") → Hello world

ENCODE_URL

Résumé

La fonction ENCODE_URL encode du texte pour qu'il puisse être utilisé dans une URL.

Syntaxe

  • ENCODE_URL(url)

Exemple

  • ENCODE_URL("Hello world") → Hello%20world

FIND

Résumé

La fonction FIND permet de chercher un élément dans une liste et de retourner la position de la première occurence. La fonction permet aussi de chercher une chaîne de caractères à l'intérieur d'une autre. Contrairement à SEARCH, cette fonction est sensible à la casse.

Syntaxe

  • FIND(liste, recherche, positionDébut = 1)

Exemple

  • FIND("b", ["a","b","c","a","b","c"]) → 2

  • FIND("world", "Hello world") → 7

  • FIND("WORLD", "Hello world") → 0

JOIN

Résumé

La fonction JOIN joint plusieurs chaînes de caractères en une seule, en utilisant un séparateur.

Syntaxe

  • JOIN(séparateur, element1, [element2, ...])

Exemple

  • JOIN("-", "Hello", "world", "!") → Hello-world-!

LEFT

Résumé

La fonction LEFT renvoie un nombre spécifié de caractères de la chaîne de caractères à partir de la gauche.

Syntaxe

  • LEFT(texte, nombre)

Exemple

  • LEFT("Hello", 3) → Hel

LEN

Résumé

La fonction LEN renvoie le nombre de caractères dans une chaîne de caractères, ou le nombre d'éléments dans une liste.

Syntaxe

  • LEN(texte)

  • LEN(liste)

Exemple

  • LEN("Hello") → 5

  • LEN([4, 5, 6]) → 3

LOWER

Résumé

La fonction LOWER transforme tous les caractères d'une chaîne de caractères en minuscules.

Syntaxe

  • LOWER(texte)

Exemple

  • LOWER("HELLO") → hello

MID

Résumé

La fonction MID renvoie une sous-chaîne d'une chaîne de caractères, en commençant à une position spécifiée et d'une longueur spécifiée.

Syntaxe

  • MID(texte, début, longueur)

Exemple

  • MID("Hello", 2, 3) → ell

PROPER

Résumé

La fonction PROPER met la première lettre de chaque mots d'un texte en majuscule.

Syntaxe

  • PROPER(texte)

Exemple

  • PROPER("hello WORLD") → Hello World

REGEX_EXTRACT

Résumé

La fonction REGEX_EXTRACT extrait les correspondances d'une expression régulière dans une chaîne de caractères.

Syntaxe

  • REGEX_EXTRACT(texte, expression_régulière)

Exemple

  • REGEX_EXTRACT("Hello123world", "\d+") → 123

REGEX_MATCH

Résumé

La fonction REGEX_MATCH vérifie si une chaîne de caractères correspond à une expression régulière donnée.

Syntaxe

  • REGEX_MATCH(texte, expression_régulière)

Exemple

  • REGEX_MATCH("Hello123", "\d+") → true

REGEX_REPLACE

Résumé

La fonction REGEX_REPLACE remplace le texte qui correspond à une expression régulière par du texte donné.

Syntaxe

  • REGEX_REPLACE(texte, expression_régulière, remplacement)

Exemple

  • REGEX_REPLACE("Hello123", "\d+", "!") → Hello!

REPLACE

Résumé

La fonction REPLACE remplace une partie d'une chaîne de caractères, en commençant à une position spécifiée et d'une longueur spécifiée, par une autre.

Syntaxe

  • REPLACE(texte, début, longueur, nouveauTexte)

Exemple

  • REPLACE("Hello", 2, 3, "world") → Hworldo

RIGHT

Résumé

La fonction RIGHT renvoie un nombre spécifié de caractères de la chaîne de caractères à partir de la droite. Contrairement à FIND, cette fonction n'est pas sensible à la casse.

Syntaxe

  • RIGHT(texte, nombre)

Exemple

  • RIGHT("Hello", 3) → llo

SEARCH

Résumé

La fonction SEARCH recherche une chaîne de caractères à l'intérieur d'une autre et renvoie la position de la première occurrence.

Syntaxe

  • SEARCH(recherche, texte)

Exemple

  • SEARCH("world", "Hello world") → 7

  • SEARCH("WORLD", "Hello world") → 7

SPLIT

Résumé

La fonction SPLIT divise une chaîne de caractères en plusieurs chaînes, basées sur un séparateur.

Syntaxe

  • SPLIT(texte, caractère)

Exemple

  • SPLIT("Hello-world", "-") → ["Hello", "world"]

SUBSTITUTE

Résumé

La fonction SUBSTITUTE remplace du texte par du nouveau texte dans une chaîne de caractères.

Syntaxe

  • SUBSTITUTE(texte, ancienTexte, nouveauTexte, occurrence = -1)

Exemple

  • SUBSTITUTE("world world", "world", "Hello", 1) → Hello world

TRIM

Résumé

La fonction TRIM supprime les espaces inutiles dans une chaîne de caractères et garde uniquement un espace entre chaque mots.

Syntaxe

  • TRIM(texte)

Exemple

  • TRIM(" Hello ") → Hello

UPPER

Résumé

La fonction UPPER transforme tous les caractères d'une chaîne de caractères en majuscules.

Syntaxe

  • UPPER(texte)

Exemple

  • UPPER("hello") → HELLO

Fonctions mathématiques

ABS

Résumé

La fonction ABS renvoie la valeur absolue de d'un nombre.

Syntaxe

  • ABS(x)

Exemple

  • ABS(-5) → 5

ACOS

Résumé

La fonction ACOS renvoie l'arc cosinus d'un nombre.

Syntaxe

  • ACOS(x)

Exemple

  • ACOS(0.5) → 1.047...

ACOSH

Résumé

La fonction ACOSH renvoie l'arc cosinus hyperbolique d'un nombre.

Syntaxe

  • ACOSH(x)

Exemple

  • ACOSH(1.5) → 0.962...

ADD

Résumé

La fonction ADD, ou l'opérateur +, renvoie la somme de deux nombres. Contrairement à SUM, cette fonction ne prend que deux arguments et peut gérer plusieurs types comme les listes ou les matrices.

Syntaxe

  • ADD(a, b)

  • a + b

Exemple

  • ADD(3, 4) → 7

  • ADD([1, 2, 3], 10) → [11, 12, 13]

  • ADD([1, 2, 3], [4, 5, 6]) → [5, 7, 9]

ASIN

Résumé

La fonction ASIN renvoie l'arc sinus d'un nombre.

Syntaxe

  • ASIN(x)

Exemple

  • ASIN(0.5) → 0.524...

ASINH

Résumé

La fonction ASINH renvoie l'arc sinus hyperbolique d'un nombre.

Syntaxe

  • ASINH(x)

Exemple

  • ASINH(0.5) → 0.481...

ATAN

Résumé

La fonction ATAN renvoie l'arc tangente d'un nombre.

Syntaxe

  • ATAN(x)

Exemple

  • ATAN(1) → 0.785...

ATANH

Résumé

La fonction ATANH renvoie l'arc tangente hyperbolique d'un nombre.

Syntaxe

  • ATANH(x)

Exemple

  • ATANH(0.5) → 0.549...

AVERAGE

Résumé

La fonction AVERAGE renvoie la moyenne des valeurs fournies. Cette fonction peut prendre plusieurs arguments ainsi que des listes ou sous-listes et s'applique sur tous les nombres trouvés.

Syntaxe

  • AVERAGE(valeur1, [valeur2, ...])

Exemple

  • AVERAGE(1, 2, 3, 4) → 2.5

  • AVERAGE(1, [[2], 3, 4]) -> 2.5

CBRT

Résumé

La fonction CBRT renvoie la racine cubique d'un nombre.

Syntaxe

  • CBRT(x)

Exemple

  • CBRT(27) → 3

CEILING

Résumé

La fonction CEILING renvoie le plus grand entier (ou multiple, si spécifié) qui est supérieur ou égal à un nombre.

Syntaxe

  • CEILING(x, facteur = 0)

Exemple

  • CEILING(4.5) → 5

COS

Résumé

La fonction COS renvoie le cosinus du nombre fourni.

Syntaxe

  • COS(x)

Exemple

  • COS(1) → 0.540...

COSH

Résumé

La fonction COSH renvoie le cosinus hyperbolique d'un nombre.

Syntaxe

  • COSH(x)

Exemple

  • COSH(1) → 1.543...

DIVIDE

Résumé

La fonction DIVIDE, ou l'opérateur /, renvoie le résultat de la division de deux nombres.

Syntaxe

  • DIVIDE(a, b)

  • a / b

Exemple

  • DIVIDE(8,2) → 4

E

Résumé

E représente la constante mathématique e, qui est la base des logarithmes naturels.

Syntaxe

  • E

Exemple

  • E → 2.718... = EXP(1)

EXP

Résumé

La fonction EXP est la fonction exponentielle et renvoie donc e élevé à la puissance d'un nombre.

Syntaxe

  • EXP(x)

Exemple

  • EXP(1) → 2.718...

FACT

Résumé

La fonction FACT renvoie la factorielle d'un nombre.

Syntaxe

  • FACT(n)

Exemple

  • FACT(5) → 120

FLOOR

Résumé

La fonction FLOOR renvoie le plus grand entier (ou multiple, si spécifié) qui est inférieur ou égal à un nombre.

Syntaxe

  • FLOOR(x, facteur = 0)

Exemple

  • FLOOR(4.5) → 4

LOG

Résumé

La fonction LOG renvoie le logarithme, selon la base que vous souhaitez, d'une nombre. Le logarithme par défaut est le logarithme népérien (en base e).

Syntaxe

  • LOG(x)

Exemple

  • LOG(E) → 1

  • LOG(10,10) -> 1

MAX

Résumé

La fonction MAX renvoie la valeur maximale parmi les arguments fournis. Cette fonction peut prendre plusieurs arguments ainsi que des listes ou sous-listes et s'applique sur tous les nombres trouvés.

Syntaxe

  • MAX(valeur1, [valeur2, ...])

Exemple

  • MAX(1, 2, 3, 4) → 4

  • MAX(1, [2, 3, [4]]) → 4

MIN

Résumé

La fonction MIN renvoie la valeur minimale parmi les arguments fournis. Cette fonction peut prendre plusieurs arguments ainsi que des listes ou sous-listes et s'applique sur tous les nombres trouvés.

Syntaxe

  • MIN(valeur1, [valeur2, ...])

Exemple

  • MIN(1, 2, 3, 4) → 1

  • MIN([[1], 2, 3], 4) → 1

MINUS

Résumé

La fonction MINUS, ou l'opérateur -, renvoie la soustraction de deux nombres.

Syntaxe

  • MINUS(a, b)

  • a - b

Exemple

  • MINUS(5, 3) → 2

MOD

Résumé

La fonction MOD, ou l'opérateur %, renvoie le reste de la division de deux nombres.

Syntaxe

  • MOD(a, b)

  • a % b

Exemple

  • MOD(7, 3) → 1

MROUND

Résumé

MROUND arrondit un nombre au multiple le plus proche spécifié.

Syntaxe

MROUND(nombre, multiple)

Exemple

  • MROUND(7, 3) → 6

MULTIPLY

Résumé

La fonction MULTIPLY, ou l'opérateur *, renvoie le produit de deux nombres. Contrairement à PRODUCT, cette fonction ne prend que deux arguments et peut gérer plusieurs types comme les listes ou les matrices.

Syntaxe

  • MULTIPLY(a, b)

  • a * b

Exemple

  • MULTIPLY(3, 4) → 12

  • MULTIPLY([1, 2, 3], 10) → [10, 20, 30]

  • MULTIPLY([[1, 2, 3]], [[1], [10], [100]]) → [[321]]

PI

Résumé

PI représente la constante mathématique π (pi).

Syntaxe

  • PI

Exemple

  • PI → 3.142...

POWER

Résumé

La fonction POWER, ou POW, ou l'opérateur ^, renvoie un nombre élevé à la puissance d'un deuxième nombre.

Syntaxe

  • POWER(a, b)

  • POW(a, b)

  • a ^ b

Exemple

  • POWER(2, 3) → 8

PRODUCT

Résumé

La fonction PRODUCT renvoie le produit de ses arguments. Contrairement à MULTIPLY, cette fonction peut prendre plusieurs arguments ainsi que des listes ou sous-listes et s'applique sur tous les nombres trouvés.

Syntaxe

  • PRODUCT(a, [b, ...])

Exemple

  • PRODUCT(3, 4) → 12

  • PRODUCT(2, [3, 4]) → 24

RANDOM

Résumé

RANDOM renvoie un nombre aléatoire entre 0 et 1.

Syntaxe

RANDOM()

Exemple

  • RANDOM() → 0.472...

ROUND

Résumé

ROUND arrondit un nombre au nombre de décimales spécifié.

Syntaxe

ROUND(nombre, decimales = 0)

Exemple

  • ROUND(3.14159, 2) → 3.14

SIGN

Résumé

SIGN renvoie le signe d'un nombre, soit -1, 0 ou 1.

Syntaxe

SIGN(x)

Exemple

  • SIGN(-5) → -1

SIN

Résumé

La fonction SIN renvoie le sinus du nombre fourni.

Syntaxe

  • SIN(x)

Exemple

  • SIN(1) → 0.841...

SINH

Résumé

La fonction SINH renvoie le sinus hyperbolique d'un nombre.

Syntaxe

  • SINH(x)

Exemple

  • SINH(1) → 1.175...

SQRT

Résumé

La fonction SQRT renvoie la racine carrée d'un nombre.

Syntaxe

  • SQRT(x)

Exemple

  • SQRT(9) → 3

SUM

Résumé

La fonction SUM renvoie la somme de ces arguments. Contrairement à ADD, cette fonction peut prendre plusieurs arguments ainsi que des listes ou sous-listes et s'applique sur tous les nombres trouvés.

Syntaxe

  • SUM(a, [b, ...])

Exemple

  • SUM(1, 2, 3, 4) → 10

  • SUM(1, [2, 3, 4]) → 10

TAN

Résumé

La fonction TAN renvoie la tangente du nombre fourni.

Syntaxe

  • TAN(x)

Exemple

  • TAN(1) → 1.557...

TANH

Résumé

La fonction TANH renvoie la tangente hyperbolique d'un nombre.

Syntaxe

  • TANH(x)

Exemple

  • TANH(0.5) → 0.462...

TRUNC

Résumé

La fonction TRUNC tronque un nombre à son entier, vous pouvez choisir le nombre de chiffre après la virgule à ne pas tronquer.

Syntaxe

  • TRUNC(x)

Exemple

  • TRUNC(4.78) → 4

  • TRUNC(PI, 4) → 3.1415

Fonctions de date

DATE

Résumé

La fonction DATE crée une date à partir d'une année, d'un mois et d'un jour fournis. La date retournée est sur le fuseau horaire de Paris.

Syntaxe

DATE(année, mois, jour)

Exemple

  • DATE(2023, 10, 20) → 20/10/2023

DATE_ADD

Résumé

Syntaxe

  • DATE_ADD(date, intervalle, unité)

Exemple

Pour : {Date} = 20/10/2023

  • DATE_ADD({Date}, 5, 'days') → 25/10/2023

DATE_DIFF

Résumé

Syntaxe

  • DATE_DIFF(fin, début, unité)

Exemple

Pour : {Date de fin} = 20/10/2023 et {Date de début} = 01/10/2023

  • DATE_DIFF({Date de fin}, {Date de début}, 'days') → 19

DAY

Résumé

La fonction DAY renvoie le jour du mois pour une date donnée.

Syntaxe

  • DAY(date)

Exemple

Pour : {Date} = 20/10/2023

  • DAY({Date}) → 20

HOUR

Résumé

La fonction HOUR renvoie l'heure d'une date et heure donnée.

Syntaxe

  • HOUR(datetime)

Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

  • HOUR({Date et Heures}) → 14

ISO_WEEK_NUM

Résumé

La fonction ISO_WEEK_NUM renvoie le numéro de semaine ISO pour une date donnée.

Syntaxe

  • ISO_WEEK_NUM(date)

Exemple

Pour : {Date} = 20/10/2023

  • ISO_WEEK_NUM({Date}) → 42

MINUTE

Résumé

La fonction MINUTE renvoie les minutes d'une date et heure donnée.

Syntaxe

  • MINUTE(datetime)

Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

  • MINUTE({Date et Heures}) → 30

MONTH

Résumé

La fonction MONTH renvoie le mois pour une date donnée.

Syntaxe

  • MONTH(date)

Exemple

Pour : {Date} = 20/10/2023

  • MONTH({Date}) → 10

PARSE_DATE

Résumé

Syntaxe

PARSE_DATE(texte, format)

Exemple

  • PARSE_DATE("20/10/2023 12:10", "DD/MM/YYYY HH:mm") → 2023-10-20 12:10

SECOND

Résumé

La fonction SECOND renvoie les secondes d'une date et heure donnée.

Syntaxe

  • SECOND(datetime)

Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

  • SECOND({Date et Heures}) → 25

WEEKDAY

Résumé

La fonction WEEKDAY renvoie le jour de la semaine pour une date donnée. Le dimanche correspond à 1, le lundi à 2 et ainsi de suite jusqu'au samedi à 7.

Syntaxe

  • WEEKDAY(date)

Exemple

Pour : {Date} = 20/10/2023

  • WEEKDAY({Date}) → 6

YEAR

Résumé

La fonction YEAR renvoie l'année pour une date donnée.

Syntaxe

  • YEAR(date)

Exemple

Pour : {Date} = 20/10/2023

  • YEAR({Date}) → 2023

Fonctions de formatage

FORMAT_CURRENCY

Résumé

La fonction FORMAT_CURRENCY formate un nombre en tant que devise en utilisant les paramètres de région et de devise fournis.

Le résultat est sous forme de texte.

Syntaxe

FORMAT_CURRENCY(nombre, région, devise)

Exemple

  • FORMAT_CURRENCY(1000, "fr-FR", "EUR") → 1 000,00 €

  • FORMAT_CURRENCY(1000, "en-US", "USD") → $1,000.00

FORMAT_DATE

Résumé

La fonction FORMAT_DATE formate une date selon le format spécifié.

Les paramètres principaux sont dateStyle , qui définit le format de la date, et timeStyle, qui définit le format de l'heure, qui peuvent prendre short, medium, long ou full comme valeur.

Le résultat est sous forme de texte.

Syntaxe

FORMAT_DATE(date, format)

Exemple

Pour : {Date et Heures} = 20/10/2023 15:30:00

  • FORMAT_DATE({Date et Heures}, "DD/MM/YYYY") → 20/10/2023

  • FORMAT_DATE({Date et Heures}, "DD/MM/YY h:mm A") → 20/10/23 3:30 PM

  • FORMAT_DATE({Date et Heures}, "dddd DD MMMM YYYY, HH:mm") → vendredi 20 octobre 2023, 15:30

  • FORMAT_DATE({Date et Heures}, "DD-MM-YYYY HH [heures et] mm [minutes]") → 20-10-2023 15 heures et 30 minutes

  • FORMAT_DATE({Date et Heures}, "fr-FR, dateStyle=full") -> vendredi 20 octobre 2023

  • FORMAT_DATE({Date et Heures}, "en-US, timeStyle=short") -> 3:30 PM

  • FORMAT_DATE({Date et Heures}, "fr-FR, dateStyle=medium, timeStyle=medium") -> 20 oct. 2023, 15:30:00

  • FORMAT_DATE(DATE(2023,1,1),"en-US, dateStyle=long, timeStyle=full, timeZone=Europe/London") -> December 31, 2022 at 11:00:00 PM Greenwich Mean Time

TO_NUMBER

Résumé

La fonction TO_NUMBER convertit une chaîne de caractères en nombre.

Syntaxe

TO_NUMBER(texte)

Exemple

  • TO_NUMBER("123.45") → 123.45

TO_TEXT

Résumé

La fonction TO_TEXT convertit une variable en texte.

Syntaxe

TO_TEXT(any)

Exemple

  • TO_TEXT(12) → "12"

Fonctions de liste

COUNTIF

Résumé

La fonction COUNTIF compte le nombre d'éléments dans une liste qui correspondent à un critère donné.

Syntaxe

  • COUNTIF(liste, lambda)

Exemple

  • COUNTIF([1, 2, 3, 4, 5], x => x > 2) → 3

  • COUNTIF(["pomme", "banane", "cerise"], LAMBDA(x, x == "banane")) -> 1

EVERY

Résumé

La fonction EVERY vérifie si tous les éléments d'une liste répondent à une condition spécifiée.

Syntaxe

  • EVERY(liste, lambda)

Exemple

  • EVERY([1, 2, 3], x => x > 0) → true

  • EVERY(["pomme", "banane", "cerise"], LAMBDA(x, x !== "")) -> true

FILL

Résumé

La fonction FILL remplace une partie d'une liste, spécifiée par un numéro de début inclut et un numéro de fin non inclut, par une valeur donnée.

Syntaxe

  • FILL(liste, valeur, début, fin)

Exemple

  • FILL([0, 0, 0, 0], 10, 2, 4) → [0, 10, 10, 0]

  • FILL(["pomme", "banane", "cerise"], "fruit", 2, 4) → ["pomme", "fruit", "fruit"]

FILTER

Résumé

La fonction FILTER filtre les éléments d'une liste pour conserver ceux qui répondent à condition spécifiée.

Syntaxe

  • FILTER(liste, lambda)

Exemple

  • FILTER([1, 2, 3, 4], x => x % 2 == 0) → [2, 4]

  • FILTER(["a", "b", "c"], x => x != "b") ["a", "c"]

FLATTEN

Résumé

La fonction FLATTEN transforme une liste imbriquée en une liste à une dimension.

Syntaxe

  • FLATTEN(liste)

Exemple

  • FLATTEN([[1, 2], [3, 4]]) → [1, 2, 3, 4]

  • FLATTEN([["pomme"], ["banane", "cerise"]]) -> ["pomme", "banane", "cerise"]

INCLUDES

Résumé

La fonction INCLUDES détermine si une liste contient un élément spécifié.

Syntaxe

  • INCLUDES(liste, élément)

Exemple

  • INCLUDES([1, 2, 3], 2) → true

  • INCLUDES("Hello", "H") -> true

INDEX

Résumé

La fonction INDEX renvoie l'élément à un indice donné dans un tableau.

Syntaxe

  • INDEX(liste, indice1, indice2, ...)

Exemple

  • INDEX([1, 2, 3], 2) → 2

  • INDEX([[1, 2], [3, 4]], 2, 1) -> 3

MAP

Résumé

La fonction MAP applique une fonction à chaque élément d'une liste.

Syntaxe

  • MAP(liste, lambda)

Exemple

  • MAP([1, 2, 3], x => x * 2) → [2, 4, 6]

REDUCE

Résumé

La fonction REDUCE applique une fonction contre un accumulateur et chaque élément du tableau (de gauche à droite) pour le réduire à une seule valeur.

Syntaxe

  • REDUCE(initial, liste, lambda)

Exemple

  • REDUCE(0, [1, 2, 3, 4], (acc, x) => acc + x) → 10

  • REDUCE(10, [1, 2, 3], (acc, val) => acc * val) -> 60

REVERSE

Résumé

La fonction REVERSE inverse l'ordre des éléments d'une liste.

Syntaxe

  • REVERSE(liste)

Exemple

  • REVERSE([1, 2, 3]) → [3, 2, 1]

SLICE

Résumé

La fonction SLICE extrait une partie d'une liste spécifiée par un numéro de début inclut et un numéro de fin non inclut.

Syntaxe

  • SLICE(liste, début, fin)

Exemple

  • SLICE([1, 2, 3, 4, 5], 2, 4) → [2, 3]

SOME

Résumé

La fonction SOME teste si au moins un élément d'une liste répond à la condition fournie.

Syntaxe

  • SOME(liste, lambda)

Exemple

  • SOME([0, 1, 2], LAMBDA(x, x > 0)) → true

  • SOME([0, 0, 0], LAMBDA(x, x > 0)) → false

SORT

Résumé

La fonction SORT trie les éléments d'une liste par ordre croissant par défaut. Vous pouvez également définir votre propre fonction de comparaison pour faire le tri.

Syntaxe

  • SORT(liste)

  • SORT(liste, fonctionComparaison)

Exemple

  • SORT([3, 1, 4, 2]) → [1, 2, 3, 4]

  • SORT([3, 1, 4, 2], (a, b) => (b-a)) → [4, 3, 2, 1]

  • SORT(["pomme", "banane", "cerise"]) → ["banane", "cerise", "pomme"]

SPLICE

Résumé

La fonction SPLICE change le contenu d'une liste en retirant, remplaçant ou ajoutant de nouveaux éléments. Il faut choisir un indice de début à partir duquel commencer les modifications, puis préciser le nombre d'éléments à supprimer, et enfin choisir les éléments à ajouter.

Syntaxe

  • SPLICE(liste, début, nbrSuppression, élément1, [élément2, ...])

Exemple

  • SPLICE([1, 2, 3, 4], 2, 0, 'a', 'b') → [1, 'a', 'b', 2, 3, 4]

  • SPLICE(["pomme", "banane", "cerise"], 3, 1, "fraise") -> ["pomme", "banane", "fraise"]

SUMIF

Résumé

La fonction SUMIF additionne les valeurs de la liste liste_sum dont les éléments correspondant dans liste répondent à une condition spécifiée.

Syntaxe

  • SUMIF(liste, lambda, liste_sum = liste)

Exemple

  • SUMIF([1, 2, 3, 4], x => x > 2) → 7

  • SUMIF([1, 2, 3, 4], x => x % 2 === 0, [10, 20, 30, 40]) → 60

SUMPRODUCT

Résumé

La fonction SUMPRODUCT renvoie la somme des produits des éléments de deux listes.

Syntaxe

  • SUMPRODUCT(liste1, liste2)

Exemple

  • SUMPRODUCT([1, 2, 3], [4, 5, 6]) → 32

SUMPRODUCTIF

Résumé

La fonction SUMPRODUCTIF calcule la somme des produits des éléments de deux liste dont les éléments correspondant dans une première liste répondent à une condition spécifiée.

Syntaxe

  • SUMPRODUCTIF(liste, lambda, liste1, liste2)

Exemple

  • SUMPRODUCTIF([2, 4, 6], x => x > 3, [1, 2, 3], [4, 5, 6]) → 28

UNIQUE

Résumé

La fonction UNIQUE supprime les doublons dans une liste donnée.

Syntaxe

  • UNIQUE(liste)

Exemple

  • UNIQUE([1, 2, 2, 3, 3, 3, 4]) → [1, 2, 3, 4]

Fonctions sur des champs particuliers

Adresse

ADDRESS_LAT

Résumé

La fonction ADDRESS_LAT renvoie la latitude d'une adresse donnée.

Syntaxe

ADDRESS_LAT(adresse)

Exemple

  • ADDRESS_LAT({Adresse}) → 48.849185

ADDRESS_LNG

Résumé

La fonction ADDRESS_LNG renvoie la longitude d'une adresse donnée.

Syntaxe

ADDRESS_LNG(adresse)

Exemple

  • ADDRESS_LNG({Adresse}) → 2.337352

ADDRESS_DESC

Résumé

La fonction ADDRESS_DESC renvoie la description d'une adresse donnée.

Syntaxe

ADDRESS_DESC(adresse)

Exemple

  • ADDRESS_DESC({Adresse}) → 15 Rue de Vaugirard, Paris, France

ADDRESS_CITY

Résumé

La fonction ADDRESS_CITY renvoie la ville d'une adresse donnée.

Syntaxe

ADDRESS_CITY(adresse)

Exemple

  • ADDRESS_CITY({Adresse}) → Paris

ADDRESS_COUNTRY

Résumé

La fonction ADDRESS_COUNTRY renvoie le pays d'une adresse donnée.

Syntaxe

ADDRESS_COUNTRY(adresse)

Exemple

  • ADDRESS_COUNTRY({Adresse}) → France

ADDRESS_POSTCODE

Résumé

La fonction ADDRESS_POSTCODE renvoie le code postal d'une adresse donnée.

Syntaxe

ADDRESS_POSTCODE(adresse)

Exemple

  • ADDRESS_POSTCODE({Adresse}) → 75006

Plage de dates / Plage de dates avec heure

DATE_RANGE

Résumé

La fonction DATE_RANGE renvoie une plage des dates de début et de fin spécifiées.

Syntaxe

DATE_RANGE(début, fin)

Exemple

  • DATE_RANGE({Début}, {Fin}) → 01/01/2023 12:30 - 31/12/2023 12:30

DATE_RANGE_BEGIN

Résumé

La fonction DATE_RANGE_BEGIN renvoie la date de début d'une plage de dates donnée.

Syntaxe

DATE_RANGE_BEGIN(plage_de_dates)

Exemple

  • DATE_RANGE_BEGIN({Plage de dates}) → 01/01/2023 12:30

DATE_RANGE_END

Résumé

La fonction DATE_RANGE_END renvoie la date de fin d'une plage de dates donnée.

Syntaxe

DATE_RANGE_END(plage_de_dates)

Exemple

  • DATE_RANGE_END({Plage de dates}) → 31/12/2023 12:30

Single select

SINGLE_SELECT_TEXT

Résumé

La fonction SINGLE_SELECT_TEXT renvoie le texte de l'option sélectionnée d'un single select.

Syntaxe

SINGLE_SELECT_TEXT(single_select)

Exemple

  • SINGLE_SELECT_TEXT({Single select}) → Option 1

  • SINGLE_SELECT_TEXT({Liaisons multiples → Single select}) → [Option 1, Option 2, Option 1]

SINGLE_SELECT_NBR_VALUE

Résumé

La fonction SINGLE_SELECT_NBR_VALUE renvoie la valeur de l'option sélectionnée d'un single select.

Syntaxe

SINGLE_SELECT_NBR_VALUE(single_select)

Exemple

  • SINGLE_SELECT_NBR_VALUE({Single select}) → 10

  • SINGLE_SELECT_NBR_VALUE({Liaisons multiples → Single select}) → [10, 20, 10]

Multi select

MULTI_SELECT_TEXT_VALUES

Résumé

La fonction MULTI_SELECT_TEXT_VALUES renvoie la liste des textes des options sélectionnées d'un multi select.

Syntaxe

MULTI_SELECT_TEXT_VALUES(multi_select)

Exemple

  • MULTI_SELECT_TEXT_VALUES({Multi select}) → [Option 1, Option 3]

  • MULTI_SELECT_TEXT_VALUES({Liaisons multiples → Multi select}) → [[Option 1, Option 3], [Option 1]]

MULTI_SELECT_NBR_VALUES

Résumé

La fonction MULTI_SELECT_NBR_VALUES renvoie la liste des valeurs des options sélectionnées d'un multi select.

Syntaxe

MULTI_SELECT_NBR_VALUES(multi_select)

Exemple

  • MULTI_SELECT_NBR_VALUES({Multi select}) → [10, 30]

  • MULTI_SELECT_NBR_VALUES({Liaisons multiples → Multi select}) → [[10, 30], [10]]

Fichier

FILENAME

Résumé

La fonction FILENAME renvoie le nom d'un fichier.

Syntaxe

FILENAME(fichier)

Exemple

  • FILENAME({fichier}) → nom_de_fichier.pdf

Fichiers Multiples

FILENAMES

Résumé

La fonction FILENAMES renvoie les noms des fichiers du champ fichiers multiples mis en paramètres.

Syntaxe

FILENAME(Fichiers Multiples)

Exemple

  • FILENAME({fichiers_multiples}) → "nom_de_fichier_1.pdf, nom_de_fichier_2.pdf"

COUNT_FILES

Résumé

La fonction COUNT_FILES renvoie le nombre de fichiers présents dans le champ fichiers multiples mis en paramètres.

Syntaxe

COUNT_FILES(Fichiers Multiples)

Exemple

  • COUNT_FILES({fichiers_multiples}) → 2

Couleur

COLOR_HEX

Résumé

La fonction COLOR_HEX récupère la valeur hexadécimale d'un champ couleur sous forme de texte.

Syntaxe

COLOR_HEX(Couleur)

Exemple

  • COLOR_HEX(Couleur) → "#000000"

TO_COLOR

Résumé

La fonction TO_COLOR transforme une valeur hexadécimale en un champ couleur.

Syntaxe

TO_COLOR("uneValeurHexadecimale")

Exemple

  • TO_COLOR("#000000") → champ couleur avec valeur #000000

Logique /Autre

AND

Résumé

La fonction AND, ou l'opérateur &&, teste si toutes les conditions fournies sont vraies.

Syntaxe

  • AND(condition1, condition2, ...)

  • condition1 && condition2 && ...

Exemple

  • AND(true, true) → true

CHOOSE

Résumé

La fonction CHOOSE sélectionne une valeur d'une liste en fonction d'un index fourni.

Syntaxe

  • CHOOSE(index, valeur1, [valeur2, ...])

Exemple

  • CHOOSE(2, "Un", "Deux", "Trois") → Deux

EQ

Résumé

La fonction EQ, ou les opérateurs =, ==, ou ===, teste l'égalité entre deux valeurs.

Syntaxe

  • EQ(value1, value2)

  • value1 = value2

  • value1 == value2

  • value1 === value2

Exemple

  • EQ(5, 5) → true

EVAL

Résumé

La fonction EVAL évalue une expression fournie sous forme de chaîne.

Syntaxe

  • EVAL(expression)

Exemple

  • EVAL("5 + 5") → 10

GT

Résumé

La fonction GT, ou l'opérateur >, teste si une valeur est supérieure à une autre.

Syntaxe

  • GT(valeur1, valeur2)

  • valeur1 > valeur2

Exemple

  • GT(6, 5) → true

GTE

Résumé

La fonction GTE, ou l'opérateur >=, teste si une valeur est supérieure ou égale à une autre.

Syntaxe

  • GTE(valeur1, valeur2)

  • valeur1 >= valeur2

Exemple

  • GTE(5, 5) → true

IF

Résumé

La fonction IF renvoie une valeur si une condition est vraie et une autre si elle est fausse.

Syntaxe

  • IF(condition, valeur_si_vrai, valeur_si_faux)

Exemple

  • IF(5 > 3, "Un", "Deux") → Un

IFS

Résumé

La fonction IFS évalue une liste de conditions et renvoie la première valeur correspondante.

Syntaxe

  • IFS(condition1, valeur1, [condition2, valeur2, ...])

Exemple

  • IFS(true, "Un", false, "Deux") → Un

IS_EMPTY

Résumé

La fonction IS_EMPTY la valeur est vide. Cette fonction peut prendre tous les types de valeurs comme paramètre.

Syntaxe

  • IS_EMPTY(valeur)

Exemple

  • IS_EMPTY({Texte}) → true si {Texte} est vide, sinon false.

LAMBDA

Résumé

La fonction LAMBDA, ou l'opérateur =>, crée une fonction anonyme avec les paramètres et le corps fournis.

Syntaxe

  • LAMBDA(paramètres, expression)

  • (paramètres => expression)

Exemple

  • LAMBDA(x, x + 5)(5) → 10

  • (x => x + 5)(5) → 10

LET

Résumé

La fonction LET définit une variable pour une utilisation dans une expression. LET peut prendre plusieurs jeux de variables/valeurs.

Syntaxe

  • LET(variable1, valeur1, variable2, valeur2, ..., expression)

Exemple

  • LET(x, 5, x + 5) → 10

  • LET(x, 5, y, 10, x * y) → 50

LT

Résumé

La fonction LT, ou l'opérateur <, teste si une valeur est inférieure à une autre.

Syntaxe

  • LT(valeur1, valeur2)

  • valeur1 < valeur2

Exemple

  • LT(4, 5) → true

LTE

Résumé

La fonction LTE, ou l'opérateur <=, teste si une valeur est inférieure ou égale à une autre.

Syntaxe

  • LTE(valeur1, valeur2)

  • valeur1 <= valeur2

Exemple

  • LTE(5, 5) → true

NE

Résumé

La fonction NE, ou les opérateurs <>, !=, ou !==, testent la non-égalité entre deux valeurs.

Syntaxe

  • NE(valeur1, valeur2)

  • valeur1 <> valeur2

  • valeur1 != valeur2

  • valeur1 !== valeur2

Exemple

  • NE(5, 6) → true

  • NE("texte1", "texte2") → true

NOT

Résumé

La fonction NOT, ou l'opérateur !, inverse la valeur logique fournie.

Syntaxe

  • NOT(valeur)

  • !valeur

Exemple

  • NOT(true) → false

OR

Résumé

La fonction OR, ou l'opérateur ||, teste si au moins une des conditions fournies est vraie.

Syntaxe

  • OR(condition1, condition2, ...)

  • condition1 || condition2 || ...

Exemple

  • OR(true, false) → true

Vous pouvez retrouver la documentation sur les expressions régulières .

Vous pouvez retrouver la documentation sur les expressions régulières .

Vous pouvez retrouver la documentation sur les expressions régulières .

La fonction DATE_ADD ajoute un intervalle spécifié à une date donnée. Vous pouvez retrouver la liste des unités possibles .

La fonction DATE_DIFF renvoie la différence entre deux dates. Vous pouvez retrouver la liste des unités possibles .

La fonction PARSE_DATE analyse une chaîne de caractères représentant une date en utilisant le format fourni et renvoie une date. La date retournée est sur le fuseau horaire de Paris. Vous pouvez retrouver la liste des formats possibles .

Vous pouvez mettre le format pour une région particulière, puis ajouter des paramètres séparés par des virgules, dont vous pouvez trouver la documentation .

Vous pouvez aussi mettre un format encore plus personnalisé en ne précisant pas la région et en plaçant chaque élément de la date où vous le souhaitez comme par exemple "DD-MM-YYYY HH [heures et] mm [minutes]". Les crochets sont des caractères d'échappement, ils permettent de préciser le texte qui doit être affiché tel quel et qui ne doit pas être interprétés comme du formatage. Vous pouvez retrouver la liste des formats possibles .

➗
ici
ici
ici
ici
ici
ici
ici
ici
Ajouter une formule depuis un workflow ou suivi
Ajouter une formule depuis la vue Data
Éditeur de formule
Graphique des tables
Variables à sélectionner dans la formule
Condition d’affichage de la ligne