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.