Formules pour les valeurs de colonne dans Générateur de tables

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 14 minutes de lecture
  • Vous pouvez utiliser une fonction prédéfinie et créer une formule pour calculer la valeur d’une colonne sans écrire de script. Utilisez une fonction prédéfinie ou créez une formule imbriquée à l’aide des fonctions prédéfinies existantes pour calculer le type de valeur de colonne.

    Opérateurs pris en charge

    Les opérateurs de comparaison suivants ne sont pris en charge que pour les valeurs de type nombre.
    • = (Égal à)
    • <> (non égal à)
    • > (supérieur à)
    • < (inférieur à)
    • >= (Supérieur ou égal à)
    • <= (inférieur ou égal à)

    Fonctions mathématiques simples

    Utilisez des fonctions mathématiques simples pour effectuer des calculs mathématiques de base sur des colonnes de valeurs numériques.

    MOYENNE

    Renvoie la valeur moyenne des arguments.

    Syntaxe Entrée Sortie
    AVERAGE(argument 1, argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : AVERAGE(1,2,3)

      Le résultat est 2.

    • Formule : AVERAGE(LENGTH(first_name), LENGTH(last_name))

      Le résultat est la valeur moyenne du nombre de caractères dans la colonne first_name et last_name colonne.

    DIVISER

    Renvoie la valeur du quotient final après avoir divisé consécutivement le premier argument avec l’argument suivant jusqu’à ce que la fonction atteigne le dernier argument.

    Syntaxe Entrée Sortie
    DIVIDE(argument 1, argument 2 ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : DIVIDE(10,20, 0.25, 10)

      Le résultat est de 0,2.

    • Formule : DIVIDE(LENGTH(full_name),2)

      Le résultat est le nombre de caractères dans la colonne full_name divisé par 2.

    INDEXMATCH

    Récupère la première valeur non nulle à partir de l’ensemble d’arguments spécifié.
    Syntaxe Entrée Sortie
    INDEXMATCH(argument 1, argument 2 , ... argument n)

    chaîne, valeur numérique, appel de fonction ou variable.

    Valeur numérique
    Exemple :

    Fonction : INDEXMATCH(«  », » « ,2,"string »)

    Le résultat est 2.

    MAX

    Renvoie la valeur la plus élevée des arguments spécifiés.

    Syntaxe Entrée Sortie
    MAX(argument 1, argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : MAX(1, -5, 20, 6)

      Le résultat est 20.

    • Formule : MAX(LENGTH(first_name), LENGTH(last_name))

      Le résultat est le nombre de caractères dans la colonne first_name ou last_name colonne, selon le chiffre le plus élevé.

    MIN.

    Renvoie la valeur la plus faible des arguments spécifiés.

    Syntaxe Entrée Sortie
    MIN(argument 1, argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : MIN(1, -5, 20, 6)

      Le résultat est -5.

    • Formule : MIN(LONGUEUR(first_name), LONGUEUR(last_name))

      Il en résulte le nombre de caractères dans la colonne first_name ou last_name colonne, selon le chiffre le plus bas.

    MULTIPLIER

    Renvoie la valeur totale multipliée des arguments.

    Syntaxe Entrée Sortie
    MULTIPLY (argument 1, argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : MULTIPLY(12, 4)

      Le résultat est 48.

    • Formule : MULTIPLY(order, 2)

      Le résultat est la valeur de colonne d’ordre multipliée par 2.

    POUVOIR

    Renvoie le résultat de la valeur de base élevé à la puissance de la valeur de l'exposant.

    Syntaxe Entrée Sortie
    POWER(argument 1, argument 2) l’argument 1 est la base et l’argument 2 est l’exposant.
    • base : nombre ou variable
    • exposant : nombre ou variable
    Numéro
    Exemples :
    • Fonction : POWER(3,2)

      Le résultat est 9.

    • Formule : POWER(LENGTH(full_name),2)

      Le résultat est le nombre de caractères dans la colonne full_name à la puissance 2.

    SOUSTRAIRE

    Renvoie la valeur du résultat après avoir soustrait consécutivement le prochain argument disponible de l’argument précédent jusqu’à ce que la fonction atteigne le dernier argument.

    Syntaxe Entrée Sortie
    SUBTRACT(argument 1, argument 2 ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : SUBTRACT(1.15, 0.02, 0.45, -0.85)

      Le résultat est de 1,53.

    • Formule : SUBTRACT(LENGTH(full_name), LENGTH(first_name))

      Le résultat est le nombre de caractères de la colonne full_name moins le nombre de caractères de la colonne first_name.

    SOMME

    Renvoie la somme de tous les arguments.

    Syntaxe Entrée Sortie
    SUM(argument 1,argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : SUM(0,03, -0,02, 1)

      Le résultat est de 1,01.

    • Formule : SOMME(LONGUEUR(first_name), LONGUEUR(last_name))

      Il en résulte le nombre total de caractères dans la colonne first_name plus le nombre total de caractères dans la colonne last_name.

    COMPTE SI

    Renvoie le nombre d’arguments qui correspondent aux critères spécifiés dans le jeu d’arguments spécifié.
    Syntaxe Entrée Sortie
    COUNTIF(argument 1, argument 2, argument n-1, critères)
    • argument 1 ... argument n : chaîne, valeur numérique, appel de fonction ou variable.
    • critères : critères qui évaluent le jeu d’arguments spécifié. chaîne, valeur numérique, appel de fonction ou variable.
    Valeur numérique
    Exemple :

    Fonction : COUNTIF(2,3,2,"string »,2)

    Le résultat est 2.

    MODE

    Renvoie la valeur qui se répète le plus fréquemment dans le jeu d’arguments spécifié.
    Syntaxe Entrée Sortie
    MODE(argument 1,argument 2, ... argument n) valeur numérique, appel de fonction ou variable Valeur numérique
    Exemple :

    Fonction : MODE(1, 2, 2, 3, 3, 3)

    Le résultat est 3.

    Fonctions de chaînes

    Utilisez les fonctions de chaîne pour reformater ou effectuer des calculs sur les valeurs de colonne de chaîne.

    CONCATÉNER

    Réunit une ou plusieurs chaînes d'entrée en une seule chaîne.

    Syntaxe Entrée Sortie
    CONCATENATE(chaîne 1, chaîne 2, ... chaîne n) chaîne, appel de fonction ou variable Chaîne
    Exemples :
    • Fonction : CONCATENATE(first_name, « . », last_name, « @ », LOWERCASE(example), « .com »)

      Le résultat est la valeur concaténée <first_name_value>.<last_name_value>@example.com. Dans cet exemple, <first_name_value> et <last_name_value> sont des espaces réservés.

    • Fonction : CONCATÉNER (first_name, " « , last_name)

      Le résultat est la chaîne concaténée de first_name valeur de colonne et last_name valeur de colonne séparées par un espace.

    ISBLANK

    Recherche les espaces blancs ou les valeurs vides dans la chaîne de caractères et renvoie « vrai » s'il y en a.

    Syntaxe Entrée Sortie
    ISBLANK(argument) Chaîne ou valeur True ou False
    Exemples :
    • Fonction : ISBLANK(« example_string »)

      Le résultat est faux.

    • Fonction : ISBLANK(full_name)

      Le résultat n’est vrai que lorsqu’il y a des espaces vides dans la colonne full_name. Sinon, le résultat est faux.

    LONGUEUR

    Renvoie le nombre total de caractères dans la chaîne d'entrée.

    Syntaxe Entrée Sortie
    LENGTH(argument) valeur de chaîne, appel de fonction ou variable Valeur numérique
    Exemples :
    • Fonction : LENGTH(« example_string »)

      Le résultat est 14.

    • Fonction : LONGUEUR(full_name)

      Le résultat est le nombre total de caractères dans la valeur de colonne full_name.

    MINUSCULE

    Convertit la chaîne d'entrée en caractères tout en minuscule.

    Syntaxe Entrée Sortie
    LOWERCASE(argument) chaîne, appel de fonction ou variable Chaîne en minuscules
    Exemples :
    • Fonction : LOWERCASE(« ExamPle inpuT stRing »)

      Le résultat est un exemple de chaîne d’entrée.

    • Fonction : MINUSCULE(sys_created_by)

      Le résultat est la chaîne en minuscules de la valeur de colonne sys_created_by.

    REMPLACER

    Remplace les caractères de la chaîne source par ceux de la chaîne cible.

    Syntaxe Entrée Sortie
    REPLACE(source_string, target_string, replacement_string)
    • source_string : chaîne, appel de fonction ou variable
    • target_string : chaîne, appel de fonction ou variable
    • replacement_string : chaîne, appel de fonction ou variable
    Chaîne
    Exemples :
    • Fonction : REPLACE(« Pepperoni Pizza », « Pepperoni », « Cheese »)

      La chaîne de résultat est Cheese Pizza.

    • Fonction : REPLACE(« abe.tuter@example.com », « example », company_name)

      La chaîne de résultat est abe.tuter@<company_name>.com. Dans cet exemple, <company_name>est un espace réservé.

    TITLECASE

    Convertit la chaîne d'entrée en caractères de casse de titre.

    Syntaxe Entrée Sortie
    TITLECASE(argument) chaîne, appel de fonction ou variable chaîne en casse de titre
    Exemples :
    • Fonction : TITLECASE(« example string »)

      Le résultat est Example String.

    • Fonction : TITLECASE(full_name)

      Il en résulte la valeur de la colonne Nom complet dans la casse du titre.

    MAJUSCULE

    Convertit la chaîne d'entrée en caractères tout en majuscules.

    Syntaxe Entrée Sortie
    UPPERCASE(argument) valeur de chaîne, appel de fonction ou variable chaîne en majuscules
    Exemples :
    • Fonction : MAJUSCULE(« eXamPle sTring »)

      Le résultat est EXAMPLE STRING.

    • Fonction : MAJUSCULE (état)

      Le résultat est la valeur de la colonne État en majuscules.

    TROUVER

    Recherche la première occurrence d’une sous-chaîne dans une chaîne et renvoie la position de la première occurrence.
    Remarque :
    Cette fonction est sensible à la casse.
    Syntaxe Entrée Sortie
    FIND(search_string, source_string, from_index)
    • search_string : sous-chaîne, appel de fonction ou variable.
    • source_string : chaîne principale, appel de fonction ou variable.
    • from_index : position de l’index dans la chaîne principale à partir de laquelle la recherche doit commencer. valeur numérique, appel de fonction ou variable.
    valeur numérique (entier). Lorsque la sous-chaîne n’existe pas dans la chaîne principale, -1 est renvoyé.
    Exemple :

    Fonction : FIND(« morning », « Good morning »)

    Le résultat est 5.

    SEARCH

    Recherche une sous-chaîne dans une chaîne et renvoie la position de la première occurrence de la sous-chaîne.
    Remarque :
    Cette fonction est insensible à la casse.
    Syntaxe Entrée Sortie
    SEARCH(search_string, source_string, from_index)
    • search_string : sous-chaîne, appel de fonction ou variable.
    • source_string : chaîne principale, appel de fonction ou variable.
    • from_index : position de l’index dans la chaîne principale à partir de laquelle la recherche doit commencer. valeur numérique, appel de fonction ou variable.
    valeur numérique (entier). Lorsque la sous-chaîne n’existe pas dans la chaîne principale, -1 est renvoyé.
    Exemples :
    • SEARCH(« Morning », « Good morning »)

      Le résultat est 5.

    • SEARCH(« World »,"Hello world ! »)

      Le résultat est -1.

    SOUS-CHAÎNE

    Récupère une sous-chaîne à partir d’une chaîne à la position d’index et sur la longueur spécifiées.
    Syntaxe Entrée Sortie
    SUBSTRING(source_string, start_index, length)
    • source_string : chaîne, appel de fonction ou variable.
    • start_index : position dans la chaîne à partir de laquelle la sous-chaîne est extraite. valeur numérique, appel de fonction ou variable.
    • length : longueur de la sous-chaîne qui doit être extraite.
    Chaîne
    Exemple :

    SUBSTRING(« Bonjour, bonjour », 7, 4)

    La sous-chaîne de résultat est 'bonne'.

    Fonctions de date et d’heure

    Utilisez les fonctions de date et d’heure pour calculer ou reformater les valeurs de colonne de date et d’heure.

    MAINTENANT

    Renvoie la date et l’heure actuelles de l’instance au format ISO (AAAA-MM-JJ hh :mm :ss).

    Syntaxe Entrée Sortie
    MAINTENANT() aucun argument requis pour cette fonction format ISO de la date et de l'heure actuelles
    Exemple :

    Fonction : NOW()

    Le résultat est la date et l’heure actuelles au format ISO.

    AUJOURD’HUI

    Renvoie la date actuelle avec le décalage horaire par rapport au début de la journée au format ISO dans le fuseau horaire UTC.
    Syntaxe Entrée Sortie
    TODAY() aucun argument requis pour cette fonction Date actuelle avec décalage horaire par rapport au début de la journée au format ISO.
    Exemple :

    Fonction : TODAY()

    Il en résulte la date et l’heure de début actuelles de la journée au format ISO.

    TIMEDIFF

    Évalue la différence de durée entre deux dates.

    Syntaxe Entrée Sortie
    TIMEDIFF(argument1, argument2) Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable Durée
    Exemples :
    • Fonction : TIMEDIFF(« 2021-05-02 9:10:12 », « 2021-04-07 6:2:23 »)

      Le résultat est 25 03:07:49.

    • Formule : TIMEDIFF(sys_created_on, NOW())

      Il en résulte la différence de durée entre la date de sys_created_on et la date actuelle du système.

    DATEDIF

    Évalue la différence entre les deux dates en jours, mois ou années.
    Syntaxe Entrée Sortie
    DATEDIF(start_date, end_date, date_difference_unit)
    • start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.
    • end_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.
    • date_difference_unit : chaîne de caractères et « Y », « M » ou « D » en minuscules ou en majuscules. La valeur par défaut est « D ».
    Valeur numérique de durée basée sur l’unité de différence de date spécifiée.
    Exemple :

    Fonction : DATEDIF(« 2021-05-02 9:10:12 », « 2021-05-05 6:2:23 « ,"d »)

    Le résultat est 3.

    DATE

    Crée une date à partir des valeurs individuelles spécifiées d’année, de mois et de jour. La date de création est dans le fuseau horaire UTC (Temps universel coordonné).
    Syntaxe Entrée Sortie
    DATE(year,month,day)
    • year : valeur numérique, variable ou fonction.
    • mois : valeur numérique, variable ou fonction.
    • day : valeur numérique, variable ou fonction.
    Date au format ISO (AAAA-MM-JJ hh :mm :ss)
    Exemple :

    Fonction : DATE(2021,5,2)

    Résultat : 2021-05-02 00:00:00.

    JOUR

    Récupère la composante numérique du jour à partir de la date spécifiée.
    Syntaxe Entrée Sortie
    DAY(date) Date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, de variable ou de fonction. valeur numérique (entier). Les valeurs vont de 1 à 31.
    Exemples :
    • Fonction : DAY(« 2021-05-029:10:12 »)

      Le résultat est 2.

    • Fonction : DAY(NOW())

      Il en résultera le composant jour de la date et de l’heure actuelles.

    MOIS

    Récupère le composant de mois numérique à partir de la date spécifiée.
    Syntaxe Entrée Sortie
    MONTH(date) date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. valeur numérique (entier). Les valeurs sont comprises entre 1 (janvier) et 12 (décembre).
    Exemples :
    • Fonction : MONTH(« 2021-05-02 9:10:12 »)

      Le résultat est 5.

    • Fonction : DAY(NOW())

      Il en résultera le composant mois de la date et de l’heure actuelles.

    ANNÉE

    Récupère le composant de l’année à partir de la date spécifiée.
    Syntaxe Entrée Sortie
    YEAR(date) Date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, de variable ou de fonction. valeur numérique (entier)
    Exemples :
    • Fonction : YEAR(« 2021-05-02 9:10:12 »)

      Le résultat est 2021.

    • Fonction : YEAR(NOW())

      Il en résultera le composant année de la date et heure actuelles.

    JOUR DE LA SEMAINE

    Renvoie le jour numérique de la semaine correspondant à la date spécifiée. La plage de jours est de 1 (dimanche) à 7 (samedi).
    Syntaxe Entrée Sortie
    WEEKDAY(date) date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. valeur numérique (entier)
    Exemple :

    Fonction : WEEKDAY(« 2021-05-02 9:10:12 »)

    Le résultat est 1.

    TEXTE

    Récupère les composants de date spécifiques d’une date au format chaîne.
    Syntaxe Entrée Sortie
    TEXT(date, format_text)
    • date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, variable.
    • format_text : composants de date sous forme de chaîne ou de variable qui doivent être extraits.
    Chaîne
    Exemple :

    TEXT(« 2022-08-17 9:10:12 »,"aaaa-MM »)

    Le résultat est 2022-08.

    VALEUR DE DATE

    Convertit une date au format texte en une date au format ISO.
    Syntaxe Entrée Sortie
    DATEVALUE(date_text) date_text : la date stockée sous forme de texte doit être au format AAAA-MM-JJ.

    Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne.

    Exemple :

    Fonction : DATEVALUE(« 2021-05-02 »)

    Résultat : 2021-05-02 00:00:00.

    JOUR OUVRABLE

    Renvoie le jour ouvrable le plus proche de la date d’entrée spécifiée en excluant les jours fériés et les week-ends spécifiés avant ou après le nombre n de jours spécifié.
    Syntaxe Entrée Sortie
    WORKDAY(start_date, jours, jour férié 1, jour férié 2, ..., jour férié n)
    • start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.
    • days : nombre de jours sous forme de valeur numérique, de chaîne ou de fonction.
    • holiday 1...holiday n (Facultatif) : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.

    Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne.

    Exemple :

    Fonction : WORKDAY(« 2022-08-17 9:10:12 »,2)

    Le résultat est 2022-08-19 00:00:00.

    JOURS-RÉSEAU

    Calcule le nombre de jours ouvrables entre deux dates en excluant les week-ends et les dates de jours fériés spécifiées. Le nombre de jours ouvrables inclut la date de début et la date de fin.
    Syntaxe Entrée Sortie
    NETWORKDAYS(start_date,end_date,jour férié 1,jour férié 2, ... jour férié n)
    • start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.
    • end_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable.
    • Jour férié 1, Jour férié 2, ... Jours fériés n (facultatif) : liste des jours fériés à exclure lors du calcul des jours ouvrables.
    valeur numérique (entier)
    Exemple :

    Fonction : NETWORKDAYS(« 2022-08-17 20:10:12 »,"2022-08-19 9:10:12 »)

    Le résultat est 3.

    Fonctions logiques

    Utilisez des fonctions logiques pour effectuer des opérations logiques sur les valeurs de colonne.

    ET

    Exécute une opération logique AND sur les arguments.

    Syntaxe Entrée Sortie
    AND(argument 1, argument 2) chaîne, appel de fonction ou variable True ou False
    Exemples :
    • Fonction : ET(2>3, 4<5)

      Le résultat est faux.

    • Formule : ET(LONGUEUR(sys_created_by)>25, LONGUEUR(sys_updated_by)>25)

      Le résultat n’est vrai que lorsque le nombre de caractères dans les colonnes sys_created_by et sys_updated_by est supérieur à 25. Sinon, le résultat est faux.

    SI

    Exécute les instructions spécifiées en fonction de la sortie booléenne de l'expression conditionnelle.

    Syntaxe Entrée Sortie
    SI(<conditional_expression>, <do_this_when_true>, <faire this_when_false>)
    • conditional_expression : expression conditionnelle logique, appel de fonction ou variable
      Remarque :
      La comparaison logique des chaînes n’est pas prise en charge dans l’expression conditionnelle.
    • do_this_when_true : chaîne, valeur numérique, appel de fonction ou variable qui est renvoyé lorsque la condition est évaluée comme vraie
    • do_this_when_false : chaîne, valeur numérique, appel de fonction ou variable qui est renvoyé lorsque la condition est évaluée comme fausse
    chaîne, valeur numérique, appel de fonction ou variable basée sur la sortie booléenne de l’expression conditionnelle.
    Exemples :
    • Fonction : IF(number_of_incidents >= 5, « High », « Medium »)

      Si le nombre d’incidents est supérieur à 5, la chaîne « Élevé » est renvoyée. Dans les autres cas, la chaîne 'Medium' est renvoyée.

    • Fonction : IF(LENGTH(full_name) > 100, « Le nombre de caractères dépasse la limite », « Nombre de caractères dans la limite »)

      Si le nombre de caractères de la colonne full_name est supérieur à 100, la chaîne « Le nombre de caractères dépasse la limite » est renvoyée. Sinon, la chaîne « Nombre de caractères dans la limite » est renvoyée.

    OU

    Exécute une opération logique OR sur les arguments.

    Syntaxe Entrée Sortie
    OR(argument 1, argument 2) chaîne, appel de fonction ou variable True ou False
    Exemples :
    • Fonction : OU(2>3,4<5)

      Le résultat est vrai.

    • Formule : OU(LONGUEUR(first_name)>25, LONGUEUR(last_name)<25)

      Le résultat est vrai lorsque le nombre de caractères dans la colonne first_name est supérieur à 25 ou que le nombre de caractères dans la colonne last_name est inférieur à 25. Sinon, le résultat est faux.

    SIERREUR

    Évalue l’expression 1 et renvoie la valeur de l’expression 1 lorsqu’il n’y a pas d’erreur dans l’expression 1. Lorsqu’une erreur se produit lors de l’évaluation de l’expression 1, l’expression 2 est évaluée et la valeur de l’expression 2 est renvoyée.
    Syntaxe Entrée Sortie
    IFERROR(expression 1, expression 2)
    • expression 1 : arithmétique, expression logique, appel de fonction, chaîne, valeur numérique ou variable.
    • expression 2 : arithmétique, expression logique, appel de fonction, chaîne, valeur numérique ou variable.
    Résultat de l’expression 1 lorsqu’il n’y a pas d’erreurs dans l’expression 1. Dans le cas contraire, résultat de l’expression 2.
    Exemple :

    Fonction : IFERROR( MULTIPLY(snr_factor, signal), MULTIPLY( default_factor, signal))

    Si la valeur snr_factor est un nombre valide, la valeur multipliée de snr_factor avec signal est renvoyée. Si la valeur snr_factor n’est pas un nombre valide, la valeur multipliée de default_factor valeur avec signal est renvoyée.