Les champs de formule sont utilisés pour calculer différents types de valeurs, y compris les valeurs numériques, les valeurs de texte, les valeurs de date, etc. Les champs de formule et la valeur renvoyée consécutive sont associés à certains types de données, et des opérateurs spécifiques peuvent être utilisés pour chaque type de données. Il est nécessaire de comprendre le type de champs requis pour créer des champs de formule, ainsi que la compatibilité entre les types de données et les opérateurs. Par exemple, l'opérateur « * » (pour la multiplication) est utilisé sur les valeurs numériques et non pas sur les valeurs de texte.
Le tableau suivant vous aide à comprendre le type d'arguments nécessaires pour les fonctions numériques, ainsi que le type de syntaxe à utiliser.
Fonction | Description | Utilisation | Exemples |
Abs | Renvoie la valeur absolue du nombre. | Abs(number) | Abs(-42) renvoie 42 ; Abs(+33) renvoie 33 |
Ceil | Renvoie le plus petit nombre plus grand que ou égal au nombre entré. | Ceil(number) | Ceil(3.4) renvoie 4; Ceil(-3.4) returns -3 |
Plancher | Renvoie le plus grand chiffre inférieur ou égal au nombre entré. | Floor(number) | Floor(3.8) renvoie 3 ; Floor(-3.4) renvoie -4 |
Naturallog | Renvoie le logarithme naturel d'un nombre | Naturallog(number) | Naturallog(1) renvoie 0.69 |
Base10log | Renvoie le logarithme base 10 du nombre entré | Base10log(number) | Base10log(10) renvoie 1.0 |
Max | Renvoie la valeur maximale de la liste des types de données compatibles. | Max(value1, value2,...) | Max(3,1,5,2) renvoie 5; Max(0,-4,-3,2) renvoie 2 |
Min | Renvoie la valeur minimale de la liste des types de données compatibles. | Min(value1, value2,...) | Min(5,-3,0,1) renvoie -3 ; Min(5,0,.01,0.5) renvoie 0.0 |
Sqrt | Renvoie la racine carrée du nombre entré. | Sqrt(number) | Sqrt(4) renvoie 2 ; Sqrt(9) renvoie 3. |
Pour créer des champs de formule de type numérique
Le tableau suivant vous aide à comprendre le type d'arguments nécessaires pour les fonctions de formule, ainsi que le type de syntaxe à utiliser.
Fonction | Description | Utilisation | Exemples |
Len | Renvoie le nombre de caractères spécifié. | Len(string) | Len('abc') renvoie 3 ; Len(' abc ') renvoie 5 |
Find | Renvoie la énième occurrence de la chaîne de texte. | Find('string','search string',number) | Find('greenery','n',1) renvoie 5 |
Concat | Renvoie une concaténation de toutes les chaînes. | Concat('string','string',...) | Concat('FirstName',' ','LastName') renvoie FirstName LastName |
Contains | Renvoie true si la chaîne de recherche se trouve dans la chaîne, sinon renvoie false. | Contains('string','search string') | Contains('abcdef','cd') renvoie true |
Startswith | Renvoie true si la chaîne commence par la chaîne de recherche, sinon renvoie false. | Startswith('string','search string') | Startswith('abcdef','cd') renvoie false Startswith('abcdef','abc') renvoie true |
Endswith | Renvoie true si la chaîne se termine par la chaîne recherchée, sinon renvoie false. | Endswith('string','search string') | Endswith('abcdef','ab') renvoie false Endswith('abcdef','ef') renvoie true |
Lower | Convertit tous les caractères d'une chaîne en minuscules. | Lower('string') | Lower('APPLES') renvoie "apples" Lower('Apples') renvoie "apples" |
Upper | Convertit tous les caractères d'une chaîne en majuscules. | Upper('string') | Upper('apples') renvoie "APPLES" Upper('APPles') renvoie "APPLES" |
Trim | Renvoie une chaîne dont les espaces blancs placés au début et à la fin sont supprimés. | Trim('string') | Trim(' abcd ') renvoie "abcd" |
Substring | Renvoie une partie d'une chaîne d'entrée, de la position de départ dans la chaîne à la longueur spécifiée. | Substring('string',n1,n2) | Substring('abcdefg',4,7) renvoie "defg" |
Replace | Remplace chaque occurrence de la chaîne de recherche dans la chaîne entrée par la chaîne de remplacement correspondante. | Replace('string','search string','replace string') | Replace('abcdefg','abc','xyz') renvoie "xyzdefg" |
Tostring | Convertit n'importe quel argument en un type de données de chaîne. | Tostring(generic argument) | Tostring(3.4) renvoie "3.4" Tostring('') renvoie < vide > |
Pour créer des champs de formule de type chaîne
Le tableau suivant vous aide à comprendre le type d'arguments nécessaires pour les fonctions de date et heure, ainsi que le type de syntaxe à utiliser.
Fonction | Description | Utilisation | Exemples |
Newdate | Crée une date à partir de l'année, du mois, du jour et de l'heure. | Newdate(year,month,day, hour,minute,'string') | Newdate(2007,12,21,06,30,'AM') renvoie quot;21/12/2007 06:30 AM"1 |
Datepart | Renvoie la valeur de date pour l'expression de la date et de l'heure. | Datepart(datetime argument) | Datepart(Newdate(2007,12,21,06,30,'AM')) renvoie "21/12/2007"1 |
Timepart | Renvoie la valeur de l'heure pour l'expression de la date et de l'heure. | Timepart(datetime argument) | Timepart(Newdate(2007,12,21,06,30,'AM')) renvoie "06.30 AM" |
Adddate | Renvoie la date obtenue en ajoutant n (années/jours/mois/heures/minutes) à la date donnée. | Adddate(datetime,number, 'string') | Adddate(Newdate(2007,12,21,06,30,'AM'),2,'YEAR' renvoie "21/12/2009 06:30 AM"2 |
Subdate | Renvoie la date obtenue en soustrayant n (années/jours/mois/heures/minutes) à la date donnée. | Subdate(datetime,number, 'string') | Subdate (Newdate(2007,12,21,06,30,'AM'),2,'YEAR' renvoie "21/12/2005 06:30 AM"2 |
Maintenant | Renvoie la date/heure correspondant au moment présent. | Now() | Now() renvoie "19/05/2009 10:52 AM" |
Datecomp | Compare deux dates et renvoie la différence en jours en minutes. | Datecomp(Datetime, Datetime) | Datecomp(Newdate(2009,05,19,11,30,'AM'), Newdate(2009,05,19,12,30,'AM')) renvoie 660.0 3 |
Dayofmonth | Renvoie le jour du mois pour la date donnée. | Dayofmonth(Datetime) | Dayofmonth(Newdate(2009,05,19,11,30,'AM')) renvoie "19.0" |
Heure | Renvoie l'heure correspondant à la date donnée. | Hour(Datetime) | Hour(Newdate(2009,05,19,11,30,'AM')) renvoie "11.0" |
Minute | Renvoie la minute correspondant à la date donnée. | Minute(Datetime) | Minute(Newdate(2009,05,19,11,30,'AM')) renvoie "30.0" |
Mois | Renvoie le mois correspondant à la date donnée. | Month(Datetime) | Month(Newdate(2009,05,19,11,30,'AM')) renvoie "5.0" |
Année | Renvoie l'année correspondant à la date donnée | Year(Datetime) | Year(Newdate(2009,05,19,11,30,'AM')) renvoie "2009.0" |
Weekday | Renvoie le jour de la semaine (1-7) correspondant à la date d'entrée, où 1 est dimanche, 2 est lundi, etc. | Weekday(Datetime) | Weekday(Newdate(2009,05,19,11,30,'AM')) renvoie "3.0". (Car le 19 mai est un mardi)4 |
Pour créer des champs de formule de type date heure
Le tableau suivant vous aide à comprendre le type d'arguments nécessaires pour les fonctions booléennes, ainsi que le type de syntaxe à utiliser.
Fonction | Description | Utilisation | Exemples |
If | Renvoie l'une des deux valeurs, en fonction de la valeur d'une condition logique donnée. Si le test booléen est true, If() renvoie la valeur true, sinon cette fonction renvoie la valeur false. | If(Boolean,Generic, Generic)* | If(8>7,1,0) renvoie "1.0" If(8>7,'True','False') renvoie "True" |
And | Renvoie une réponse true si toutes les expressions sont vraies ; renvoie une valeur false si une des expressions est fausse. | And(boolean,boolean ...) | And(2>1,5>3,7<8) renvoie "true" And(2>1,5>3,7>8) renvoie "false" |
Ou | Renvoie true si l'une des expressions est vraie. Renvoie false si toutes les expressions sont fausses. | Or(boolean,...) | Or(2>1,3>5,7>8) renvoie "true" Or(1>2,3>5,7>8) renvoie "false" |
Not | Renvoie la négation logique de l'expression donnée (si l'expression est true, renvoie false). | Not(boolean) | Not(false) renvoie "true" Not(true) renvoie "false" |
* Le terme Generic (Générique) implique tout type de données - Number (Nombre), String (Chaîne), Datetime (Date et heure) (date normale incluse) ou Boolean (Booléen). Le type de retour dépend du type de données sélectionné. Par exemple, si le type de données générique est un nombre, le type de retour doit être numérique, et non une chaîne ou une valeur booléenne.
Pour créer des champs de formule de type booléen
Le tableau suivant affiche la référence fonctionnelle pour la création de formules avec leurs arguments disponibles.
Nom de la fonction | Nombre d'arguments requis | Type de données d'argument | Type de retour |
Abs | 1 | Nombre | Nombre |
Ceil | 1 | Nombre | Nombre |
Plancher | 1 | Nombre | Nombre |
Naturallog | 1 | Nombre | Nombre |
Base10log | 1 | Nombre | Nombre |
Max | Multiple | Tous nombres | Nombre |
Min | Multiple | Tous nombres | Nombre |
Sqrt | 1 | Nombre | Nombre |
Nom de la fonction | Nombre d'arguments requis | Type de données d'argument | >Type de retour |
Len | 1 | Chaîne | Nombre |
Find | 3 | Chaîne: Chaîne: Nombre | Nombre |
Concat | Multiple | Tous Chaîne | Chaîne |
Contains | 2 | Chaîne: Chaîne | Champs booléens |
Startswith | 2 | Chaîne: Chaîne | Champs booléens |
Endswith | 2 | Chaîne: Chaîne | Champs booléens |
Lower | 1 | Chaîne | Chaîne |
Upper | 1 | Chaîne | Chaîne |
Trim | 1 | Chaîne | Chaîne |
Substring | 3 | Chaîne: Nombre: Nombre | Chaîne |
Replace | 3 | Chaîne: Chaîne: Chaîne | Chaîne |
Tostring | 1 | Tous types de données | Chaîne |
Nom de la fonction | Nombre d'arguments requis | Type de données d'argument | Type de retour |
Newdate | 6 | Nombre:Nombre:Nombre:Nombre:Nombre:Chaîne | Datetime |
Datepart | 1 | Datetime | Chaîne |
Timepart | 1 | Datetime | Chaîne |
Adddate | 3 | Datetime: Nombre: Chaîne | Datetime |
Subdate | 3 | Datetime: Nombre: Chaîne | Datetime |
Maintenant | 0 | – | Datetime |
Datecomp | 2 | Datetime: Datetime | Nombre |
Dayofmonth | 1 | Datetime | Nombre |
Heure | 1 | Datetime | Nombre |
Minute | 1 | Datetime | Nombre |
Mois | 1 | Datetime | Nombre |
Année | 1 | Datetime | Nombre |
Weekday | 1 | Datetime | Nombre |
Nom de la fonction | Nombre d'arguments requis | Type de données d'argument | Type de retour |
If | 3 | Booléen: Générique: Générique | Générique |
And | Multiple | Tous booléens | Champs booléens |
Ou | Multiple | Tous booléens | Champs booléens |
Not | 1 | Champs booléens | Champs booléens |