Skip to main content

Référence des fonctions de workflow

Les types de fonctions suivants permettent de transformer vos données dans Live Query. Le type de données détermine les fonctions que vous pouvez utiliser.

Consultez Types de données pris en charge pour plus d'informations.

Utilisez ce guide comme référence rapide des fonctions que vous pouvez utiliser dans l'Éditeur d'expressions de Live Query. Si vous avez besoin de plus d'informations et d'exemples, consultez les pages spécifiques à chaque catégorie, proposées dans chaque section.

Conditionnel

Les fonctions conditionnelles vous permettent d'effectuer une action ou un calcul à l'aide d'une instruction conditionnelle IF. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions conditionnelles de workflow.

IF condition THEN t ELSE f ENDIF

IF c THEN t ELSE f ENDIF : renvoie t si la condition c est vraie, sinon renvoie f.

IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIF

IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIFIF c THEN t ELSE f ENDIF : renvoie t1 si la condition c est vraie, renvoie t2 si la seconde condition c2 est vraie, sinon renvoie f.

IIF

IIF(bool, x, y): renvoie x si la condition booléenne est vraie, sinon renvoie y.

Switch

Switch(Value,Default,Case1,Result1,...,CaseN,ResultN) : compare une valeur à une liste de cas et renvoie le résultat correspondant.

Conversion

Les fonctions de conversion convertissent les nombres en chaînes ou vice-versa. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions de conversion de workflow.

CharFromInt

CharFromInt(x): renvoie le caractère Unicode® qui correspond au nombre d'entrée x.

Note

This function isn't available for Live Query for Databricks.

ToDegrees

ToDegrees(x): convertit une valeur numérique (x) de radians en degrés via la formule (x)rad × 180/π. Veuillez noter que x doit être une valeur numérique et ne peut pas inclure de symbole de radian (rad).

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): convertit une chaîne (x) en nombre.

ToRadians

ToRadians(x): convertit une valeur numérique (x) de degrés en radians via la formule (x)° × π/180. Veuillez noter que x doit être une valeur numérique et ne peut pas inclure de symbole de degré (°).

ToString

ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): convertit un paramètre numérique (x) en chaîne en utilisant numDec décimales. La sélection par défaut utilise un point comme séparateur décimal.

DateHeure

Les fonctions DateHeure vous permettent d'effectuer une action ou un calcul sur une valeur de date et d'heure. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions Date et heure de workflow.

DateTimeAdd

DateTimeAdd(dt,i,u): ajoute un intervalle spécifique à une valeur de date/heure.

DateTimeDay

DateTimeDay(dt): renvoie la valeur numérique du jour du mois d'une valeur de date/heure.

DateTimeDiff

DateTimeDiff(dt1,dt2,u): soustrait le deuxième argument du premier et renvoie la différence sous forme de nombre entier. La durée est retournée sous la forme d'un nombre, et non d'une chaîne, dans les unités de temps spécifiées.

DateTimeFirstOfMonth

DateTimeFirstOfMonth(): renvoie le premier jour du mois, à minuit.

DateTimeFormat

DateTimeFormat(dt, f): convertit les données date/heure df dans un autre format f spécifié.

Note

This function isn't available for Live Query for Databricks.

DateTimeHour

DateTimeHour(dt): renvoie la partie horaire d'une valeur de date/heure.

DateTimeLastOfMonth

DateTimeLastOfMonth(): renvoie le dernier jour du mois en cours, avec l'horloge définie à une seconde avant la fin du jour (23:59:59).

DateTimeMinutes

DateTimeMinutes(dt): renvoie la partie minutes d'une valeur de date/heure.

DateTimeMonth

DateTimeMonth(dt): renvoie la valeur numérique du mois d'une valeur de date/heure.

DateTimeNow

DateTimeNow(): renvoie la date et l’heure système actuelles.

DateTimeParse

DateTimeParse(dt, f): convertit la chaîne d'une date avec un format et une langue spécifiés en format ISO standard (yyyy-mm-dd HH:MM:SS).

Note

This function isn't available for Live Query for Databricks.

DateTimeQuarter

DateTimeQuarter(dt,[Q1Start]): renvoie la valeur numérique du trimestre qui contient une valeur date/heure (AAAA-MM-JJ). Utilisez le paramètre numérique facultatif pour indiquer le mois de début du premier trimestre (Q1).

DateTimeSeconds

DateTimeSeconds(dt): renvoie la partie secondes d'une valeur de date/heure.

DateTimeToday

DateTimeToday(): renvoie la date d'aujourd'hui.

DateTimeTrim

DateTimeTrim(dt, f): retire les parties inutiles d'une valeur de date/heure et renvoie la valeur de date/heure modifiée.

Note

This function isn't available for Live Query for Databricks.

DateTimeYear

DateTimeYear(dt): renvoie la valeur numérique de l'année d'une valeur de date/heure.

ToDate

ToDate(x): convertit une chaîne, un nombre ou une valeur de date/heure en une date.

ToDateTime

DateTimeTrim(ToDateTime(x), t) : convertit une valeur de chaîne, de nombre ou de date en date/heure.

Finance

Une fonction financière applique des algorithmes financiers ou des calculs mathématiques. Pour en savoir plus, rendez-vous sur Fonctions financières de workflow.

FinanceCAGR

FinanceCAGR(BeginningValue, EndingValue, NumYears): calcule le taux de croissance annuel composé, c'est-à-dire la moyenne géométrique des taux de croissance sur une base annualisée.

FinanceEffectiveRate

FinanceEffectiveRate(NominalRate, PaymentsPerYear): calcule le taux d'intérêt annuel effectif, c'est-à-dire le taux d'intérêt sur un prêt ou un produit financier redéfini à partir du taux d'intérêt nominal en tant que taux d'intérêt, les intérêts annuels composés étant payables à terme échu.

FinanceFV

FinanceFV(Rate, NumPayments, PaymentAmount, PresentValue, PayAtPeriodBegin): calcule la valeur future d'un investissement, c'est-à-dire la valeur d'un actif à un moment futur spécifié, en supposant un taux d'intérêt ou un taux de rentabilité donné.

FinanceIRR

FinanceIRR(Value1, Value2): calcule le taux de rentabilité interne, c'est-à-dire le taux d'intérêt auquel le coût de l'investissement génère les bénéfices de celui-ci. Cela signifie que tous les gains liés à l’investissement sont inhérents à la valeur temporelle de l’argent et que l’investissement possède une valeur présente nette nulle à ce taux d’intérêt.

Note

This function isn't available for Live Query for Databricks.

FinanceNominalRate

FinanceNominalRate(EffectiveRate, PaymentsPerYear): calcule le taux d'intérêt annuel nominal. Un taux d'intérêt est dit « nominal » si la fréquence de capitalisation (par exemple, le mois) n'est pas identique à l'unité temporelle de base (normalement une année).

FinanceNPER

FinanceNPER(Rate, PaymentAmount, PresentValue, FutureValue, PayAtPeriodBegin): calcule le nombre de périodes pour un investissement ou un prêt.

FinancePMT

FinancePMT(Rate, NumPayments, PresentValue, FutureValue, PayAtPeriodBegin): calcule les paiements sur un prêt.

FinancePV

FinancePV(Rate, NumPayments, PaymentAmount, FutureValue, PayAtPeriodBegin): calcule la valeur actuelle d'un investissement, c'est-à-dire la valeur à une date donnée d'un futur paiement ou d'une série de futurs paiements, avec réduction reflétant la valeur temporelle de l'argent et d'autres facteurs tels que le risque lié à l'investissement.

FinanceXIRR

FinanceXIRR(Value1, Date1, Value2, Date2): calcule le taux de rentabilité interne d'un investissement, à plusieurs dates.

Note

This function isn't available for Live Query for Databricks.

FinanceXNPV

FinanceXNPV(Rate, Value1, Date1, Value2, Date2): calcule la valeur actuelle nette d'un investissement, à plusieurs dates.

Mathématiques

Une fonction mathématique exécute des calculs mathématiques. Pour obtenir d'autres paramètres et exemples, accédez à l'article Fonctions Mathématiques de workflow.

ABS

ABS(x): renvoie la valeur absolue de x. Cette valeur représente la distance entre 0 et un nombre. La valeur est toujours positive.

ACOS

ACOS(x): renvoie l.arc cosinus, ou le cosinus inverse, d'un nombre. L'arc cosinus correspond à l'angle dont le cosinus est (x).

ASIN

ASIN(x): renvoie l'arc sinus, ou le sinus inverse, d'un nombre (x). L'arc sinus correspond à l'angle dont le sinus est (x).

ATAN

ATAN(x): renvoie l'arc tangente, ou la tangente inverse, d'un nombre (x). L'arc tangente correspond à l'angle dont la tangente est (x). L'angle renvoyé est indiqué en radians dans la plage allant de -pi/2 à pi/2.

ATAN2

ATAN2(y, x): renvoie l'arc tangente, ou la tangente inverse, de y et x (Arc - Tangente de (y/x)).

Moyenne

Average(n1, …) : renvoie la moyenne d'une liste de nombres. Les valeurs NULL sont traitées comme 0 et prises en compte dans le calcul de la valeur moyenne.

AverageNonNull

AverageNonNull(n1, ...)Renvoie la moyenne d'une liste de nombres. Les valeurs nulles sont exclues du calcul. Le calcul fonctionne uniquement avec les types de données numériques.

CEIL

CEIL(x, [mult]) : renvoie une valeur numérique (x) élevée au multiple le plus bas de (mult), supérieure ou égale à x. Le paramètre (mult) doit être un nombre supérieur à 0. Si (mult) n'est pas spécifié, la fonction renvoie le plus petit entier qui est supérieur ou égal à (x).

COS

COS(x): renvoie le cosinus d'un angle donné (x). x doit être en radians.

EXP

EXP(x): renvoie e élevé à la puissance x.

FLOOR

FLOOR(x, [mult]): renvoie une valeur numérique (x) abaissée au multiple le plus élevé de (mult), inférieure ou égale à x. Le paramètre (mult) doit être un nombre supérieur à 0. Si (mult) n'est pas spécifié, la fonction renvoie le plus grand entier qui est inférieur ou égal à (x), comme indiqué dans l'exemple ci-dessous.

LOG

LOG(x): renvoie le logarithme naturel d'un nombre (x). x doit être un nombre positif.

LOG10

LOG10(x): renvoie le logarithme décimal d'un nombre (x). x doit être un nombre positif.

Médiane

Median(…) : calcule la médiane d'une ou de plusieurs valeurs (éventuellement non triées).

Note

This function isn't available for Live Query for Databricks.

Mod

Mod(n,d) : modulo d'un nombre (n) divisé par un nombre (d) (opération d'entiers).

PI

PI() : renvoie la valeur de la constante PI avec une précision à 15 chiffres.

POW

POW(x, e): renvoie un nombre (x) élevé à la puissance (e).

RAND

RAND(): renvoie un nombre aléatoire supérieur ou égal à 0 et inférieur à 1.

RandInt

RandInt(n): renvoie un entier aléatoire compris entre 0 et le paramètre spécifié (n).

Round

Round(x, mult) : renvoie x arrondi au multiple le plus proche du nombre spécifié dans mult.

SIN

SIN(x): renvoie le sinus d'un angle donné (x). x doit être en radians.

SmartRound

SmartRound(x): renvoie un nombre (x) arrondi au multiple le plus proche d'une valeur déterminée dynamiquement à partir de la taille de (x).

SQRT

SQRT(x): renvoie la racine carrée d'un nombre (x).

TAN

TAN(x): renvoie la tangente d'un angle donné (x). x doit être en radians.

TANH

TANH(x): renvoie la tangente hyperbolique d'un nombre (x).

Min./Max.

Une fonction minimale ou maximale recherche la plus petite et la plus grande valeur d'un ensemble de valeurs. Pour en savoir plus, rendez-vous sur Fonctions Min./Max de workflow.

Entre

BETWEEN(x, min, max): teste si une valeur (x) est comprise entre 2 autres valeurs (min et max), y compris les valeurs min et max. Renvoie TRUE si x est compris entre min et max. Renvoie FALSE si x n'est pas compris entre min et max.

Limite

Bound(x, min, max) : si (x < min) renvoie le minimum, sinon si (x > max) renvoie le maximum, sinon renvoie (x).

Maximum

Max(v0, v1, …, vn) : renvoie la valeur maximale de la liste.

Minimum

Min(v0, v1,..., vn) : renvoie la valeur minimale de la liste.

Opérateurs

Un opérateur est un caractère représentant une action. Utilisez un opérateur arithmétique pour exécuter des calculs mathématiques ou un opérateur booléen pour travailler avec des valeurs vrai/faux. Pour en savoir plus, rendez-vous sur Opérateurs de workflow.

Addition

+ : addition.

Opérateur booléen ET - Mot-clé

AND : combine 2 valeurs booléennes. Le résultat est vrai si les deux valeurs combinées sont vraies, faux si l'une d'elles est fausse mais pas nulle, et nul si l'une d'elles est nulle.

Opérateur booléen ET

&& : combine 2 valeurs booléennes. Le résultat est vrai si les deux valeurs combinées sont vraies, faux si l'une d'elles est fausse mais pas nulle, et nul si l'une d'elles est nulle.

Opérateur booléen SAUF - Mot-clé

NOT : accepte 1 entrée. Si cette entrée est vraie, elle renvoie Faux. Si cette entrée est fausse, elle renvoie Vrai. Si cette entrée est nulle, elle renvoie Nul.

Opérateur booléen SAUF

! : accepte 1 entrée. Si cette entrée est vraie, elle renvoie Faux. Si cette entrée est fausse, elle renvoie Vrai. Si cette entrée est nulle, elle renvoie Nul.

Opérateur booléen OU - Mot-clé

OR : combine 2 valeurs booléennes. Le résultat est vrai si l'une des valeurs (ou les deux) est vraie. Renvoie Nul si l'une des valeurs est nulle.

Opérateur booléen OU

|| : combine 2 valeurs booléennes. Le résultat est vrai si l'une des valeurs (ou les deux) est vraie. Renvoie Nul si l'une des valeurs est nulle.

Division

/ : division.

Égal à

= : égal à.

Supérieur à

> : supérieur à.

Supérieur ou égal à

>= : supérieur ou égal à.

Inférieur à

 : inférieur à.

Inférieur ou égal à

<= : inférieur ou égal à.

Multiplication

* : multiplication.

Différent de

!= : est différent de.

Soustraction

- : soustraction.

Valeur IN (…)

IN : valeur de test dans la liste.

Valeur NOT IN (…)

NOT IN : valeur de test absente de la liste.

Spécialisé

Ces fonctions exécutent diverses actions spécialisées et peuvent être utilisées avec tous les types de données. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions spécialisées de workflow.

NULL

NULL(): renvoie une valeur nulle.

Chaîne

Une fonction chaîne exécute des opérations sur des données de texte. Utilisez une fonction chaîne pour nettoyer les données, convertir des données dans un autre format ou casse, calculer des métriques relatives aux données ou effectuer d'autres manipulations. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions Chaîne de workflow.

Contains

Contains (String, Target, CaseInsensitive = 1) : recherche l'occurrence d'une chaîne particulière dans une chaîne. Renvoie True si (String) contient (Target), sinon, renvoie False.

CountWords

CountWords(string): renvoie le nombre de mots dans la chaîne spécifiée. Les mots sont définis comme des ensembles de caractères séparés par un espace.

Note

This function isn't available for Live Query for Databricks.

EndsWith

EndsWith(String, Target, CaseInsensitive=1): vérifie si une chaîne se termine par une chaîne particulière. Renvoie True si la chaîne (String) se termine par la chaîne cible (Target), sinon renvoie False. Par défaut, il est insensible à la casse.

FindNth

FindNth(Initial String, Target, Instance): recherche l'instance (la Nième occurrence) de la cible dans la chaîne initiale et renvoie la position indexée 0 de l'instance. Cette fonction est sensible à la casse et ne prend pas en charge les paramètres négatifs.

FindString

FindString(String,Target): recherche l'occurrence d'une chaîne particulière (Target) dans une autre chaîne (String) et renvoie la position numérique de son occurrence dans la chaîne. Renvoie l'index de base 0 de la première occurrence de (Target) dans (String). Renvoie -1 en l'absence d'occurrence.

GetLeft

GetLeft(String, Delimiter): renvoie la partie gauche de la chaîne fournie jusqu'à la première instance du ou des délimiteurs spécifiés.

GetPart

GetPart(String, Delimiter, Index): utilise le ou les délimiteurs spécifiés pour diviser la chaîne en sous-chaînes et renvoie la sous-chaîne à la position indiquée dans l'index.

GetRight

GetRight(String, Delimiter): renvoie la partie droite de la chaîne fournie après la première instance du ou des délimiteurs spécifiés.

GetWord

GetWord(string, n): renvoie le Nième mot (base 0) de la chaîne. Les mots sont définis comme des ensembles de caractères séparés par une espace. L’index en base 0 signifie que le premier mot se trouve à la position 0.

Gauche

Left(String, len) : renvoie les premiers caractères (len) de la chaîne (String). Si len est inférieur à 0 ou supérieur à la longueur de la chaîne (String), la chaîne reste inchangée.

Longueur

Length(String) : renvoie la longueur de la chaîne (String).

LowerCase

LowerCase(String): convertit une chaîne en minuscules.

PadLeft

PadLeft (String, len, char) : remplit le côté gauche de la chaîne (String) avec le caractère spécifié jusqu’à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.

PadRight

PadRight (String, len, char) : remplit le côté droit de la chaîne (String) avec le caractère spécifié jusqu’à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.

REGEX_CountMatches

REGEX_CountMatches(String,pattern,icase): renvoie le nombre de concordances dans la chaîne avec le schéma.

Note

This function isn't available for Live Query for Databricks.

REGEX_Match

REGEX_Match(String,pattern,icase): recherche une occurrence d'une expression régulière dans une chaîne. Indique si la chaîne concorde avec le schéma du premier caractère jusqu’à la fin.

Note

This function isn't available for Live Query for Databricks.

REGEX_Replace

REGEX_Replace(String, pattern, replace, icase): renvoie la chaîne résultant du modèle de recherche RegEx et de la chaîne de remplacement.

Note

This function isn't available for Live Query for Databricks.

Remplacer

Replace(String, Target, Replacement) : renvoie la chaîne (String) après avoir remplacé chaque occurrence de la chaîne (Target) par la chaîne (Replacement).

ReplaceChar

ReplaceChar(String, y, z): renvoie la chaîne (String) après le remplacement de chaque occurrence du caractère (y) par le caractère (z). Si le caractère de remplacement (z) est une chaîne comportant plusieurs caractères, seul le premier caractère est utilisé. Si (z) est vide, chaque caractère (String) qui correspond à n’importe quel caractère dans (y) est simplement supprimé.

ReplaceFirst

ReplaceFirst(String, Target, Replacement): renvoie la chaîne (String) après le remplacement de la première occurrence de la chaîne (Target) par la chaîne de remplacement (Replacement).

ReverseString

ReverseString(String): inverse tous les caractères de la chaîne.

Note

This function isn't available for Live Query for Databricks.

Droit

Right(String, len) : renvoie les derniers caractères (len) de la chaîne. Si len est inférieur à 0 ou supérieur à la longueur de String, la chaîne reste inchangée.

StartsWith

StartsWith(String, Target, CaseInsensitive=1): vérifie si une chaîne commence par une chaîne particulière. Renvoie vrai si la chaîne commence par une chaîne spécifique (Target), sinon renvoie faux.

STRCSPN

STRCSPN(String, y): renvoie la longueur du segment initial de la chaîne (String) composé de caractères qui ne sont pas dans la chaîne(y).

StripQuotes

StripQuotes(String): retire un jeu de guillemets ou d'apostrophes des extrémités de la chaîne.

STRSPN

STRSPN(String, y): renvoie la longueur du segment initial de la chaîne (String) composé de caractères de la chaîne (y).

Substring

Substring(String, start, length) : retourne la sous-chaîne de la chaîne (String), en commençant par (start) et en s’arrêtant après la longueur indiquée par (lenght), si elle est fournie.

TitleCase

TitleCase(String): convertit la chaîne en majuscules.

Trim

Trim(String, y) : supprime le(s) caractère(s) de la chaîne (y) du début et de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides. Notez dans les exemples de la fonction TRIM que les caractères spécifiés sont supprimés. L’ordre des caractères n’a pas d’importance.

TrimLeft

TrimLeft(String, y): supprime les caractères de la chaîne (y) du début de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.

TrimRight

TrimRight(String, y): supprime les caractères de la chaîne (y) de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.

Majuscule

Uppercase(String) : convertit la chaîne (String) en lettres majuscules.

Test

Une fonction de test effectue des comparaisons de données. Utilisez une fonction test pour identifier le type de données d’une valeur ou déterminer si une valeur existe. Pour obtenir des paramètres et des exemples, rendez-vous sur Fonctions Test de workflow.

CompareDigits

CompareDigits(a, b, nNumDigits): compare 2 nombres et détermine s'ils sont identiques à la quantité de chiffres donnée (nNumDigits).

CompareEpsilon

CompareEpsilon(a, b, epsilon): compare 2 nombres à virgule flottante et renvoie « True » s'ils sont dans epsilon.

EqualStrings

EqualStrings(a,b): compare la chaîne (a) à la chaîne (b) pour déterminer s'il s'agit d'une correspondance exacte. La fonction renvoie « True » si tous les caractères de la chaîne (a) et de la chaîne (b) sont identiques et « False » si un ou plusieurs caractères ne sont pas identiques.

IsEmpty

IsEmpty(v): teste si v est NULL ou égal à "".

IsInteger

IsInteger(v): contrôle si (v) contient une valeur convertible en entier. Si c'est le cas, la fonction renvoie « True ».

IsLowerCase

IsLowerCase(String): renvoie « True » si tous les caractères alphabétiques (un ou plusieurs) d'une chaîne sont en minuscules et « False » si un ou plusieurs caractères alphabétiques sont en majuscules. La fonction ignore les caractères non alphabétiques. Notez que cette fonction s'applique uniquement aux caractères avec une distinction entre majuscules et minuscules et peut ne pas s'appliquer aux caractères dans toutes les langues.

IsNull

IsNull(v): contrôle si (v) est null. Renvoie « True » si v est null, sinon renvoie « False ».

IsNumber

IsNumber(v): contrôle si le type de champ de (v) est un nombre ou non.

IsString

IsString(v): contrôle si le type de champ de (v) est une chaîne ou non.

IsUpperCase

IsUpperCase(String): renvoie « True » si tous les caractères alphabétiques (un ou plusieurs) d'une chaîne sont en majuscules et « False » si un ou plusieurs caractères alphabétiques sont en minuscules. La fonction ignore les caractères non alphabétiques. Notez que cette fonction s'applique uniquement aux caractères avec une distinction entre majuscules et minuscules et peut ne pas s'appliquer aux caractères dans toutes les langues.