--- schema_version: "1" id: a3071e16724c4b4dfabb353a945026747f0cccd17ac3b54e248f76a134092c87 title: Toutes les fonctions (par catégorie) collection: tableau version: current locale: fr-ca portal_url: https://docs.salesforce.com/tableau/current/fr-ca/pro/desktop/functions_all_categories.md canonical_url: https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_categories.htm source_site: help.tableau.com content_type: documentation content_hash: 88bbbbf67ff3321c7ef7141c4396e6a1ecd1526ef72fa776d661781e4967083d description: Reference of all Tableau calculation functions organized by category. --- [Passer au contenu principal](#main-content) # Fonctions de Tableau (par catégorie) Dans cette référence, les fonctions de Tableau sont organisées par catégorie. Cliquez sur une catégorie pour parcourir ses fonctions. Vous pouvez sinon appuyer sur Ctrl+F (Cmd-F sur un Mac) pour ouvrir un champ de recherche et l’utiliser pour rechercher la page d’une fonction spécifique. Fonctions de nombre ### ABS

Syntaxe	`ABS(number)`
Résultat	Nombre (positif)
Définition	Renvoie la valeur absolue d’un `<number>` donné.
Exemple	ABS(-7) = 7 ABS([Budget Variance]) Le deuxième exemple renvoie la valeur absolue de tous les nombres contenus dans le champ Écart budgétaire.
Remarques	Voir aussi `SIGN`.

### ACOS

Syntaxe	`ACOS(number)`
Résultat	Nombre (angle en radians)
Définition	Renvoie l’arc cosinus (angle) d’un `<number>` donné.
Exemple	ACOS(-1) = 3.14159265358979
Remarques	La fonction inverse, `COS`, utilise l’angle exprimé en radians comme argument et renvoie le cosinus.

### ASIN

Syntaxe	`ASIN(number)`
Résultat	Nombre (angle en radians)
Définition	Renvoie l’arc sinus (angle) d’un `<number>` donné.
Exemple	ASIN(1) = 1.5707963267949
Remarques	La fonction inverse, `SIN`, utilise l’angle exprimé en radians comme argument et renvoie le sinus.

### ATAN

Syntaxe	`ATAN(number)`
Résultat	Nombre (angle en radians)
Définition	Renvoie l’arc tangente (angle) d’un `<number>` donné.
Exemple	ATAN(180) = 1.5652408283942
Remarques	La fonction inverse, `TAN`, utilise l’angle exprimé en radians comme argument et renvoie la tangente. Voir aussi `ATAN2` et `COT`.

### ATAN2

Syntaxe	`ATAN2(y number, x number)`
Résultat	Nombre (angle en radians)
Définition	Renvoie l’arc tangente (angle) entre deux nombres (x et y). Le résultat est exprimé en radians.
Exemple	ATAN2(2, 1) = 1.10714871779409
Remarques	Voir aussi `ATAN`, `TAN` et `COT`.

### CEILING

Syntaxe	`CEILING(number)`
Résultat	Entier
Définition	Arrondit un `<number>` à l’entier le plus proche ou à la valeur la plus importante.
Exemple	CEILING(2.1) = 3
Remarques	Voir aussi `FLOOR` et `ROUND`.
Limites de la base de données	`CEILING` est disponible par l’intermédiaire des connecteurs suivants : Microsoft Excel, Fichier texte, Fichier de statistiques, sources de données publiées, Amazon EMR Hadoop Hive, Amazon Redshift, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

### COS

Syntaxe	`COS(number)` L’argument numérique est l’angle exprimé en radians.
Résultat	Nombre
Définition	Renvoie le cosinus d’un angle.
Exemple	COS(PI( ) /4) = 0.707106781186548
Remarques	La fonction inverse, `ACOS`, utilise le cosinus comme argument et renvoie l’angle en radians. Voir aussi `PI`. Pour convertir un angle de degrés en radians, utilisez `RADIANS`.

### COT

Syntaxe	`COT(number)` L’argument numérique est l’angle exprimé en radians.
Résultat	Nombre
Définition	Renvoie la cotangente d’un angle.
Exemple	COT(PI( ) /4) = 1
Remarques	Voir aussi `ATAN`, `TAN` et `PI`. Pour convertir un angle de degrés en radians, utilisez `RADIANS`.

### DEGREES

Syntaxe	`DEGREES(number)` L’argument numérique est l’angle exprimé en radians.
Résultat	Nombre (degrés)
Définition	Convertit en degrés un angle exprimé en radians.
Exemple	DEGREES(PI( )/4) = 45.0
Remarques	La fonction inverse, `RADIANS`, utilise un angle exprimé en degrés et le renvoie en radians. Voir aussi `PI()`.

### DIV

Syntaxe	`DIV(integer1, integer2)`
Résultat	Entier
Définition	Retourne la part d’entier d’une opération de division, à savoir `<integer1>` divisé par `<integer2>`.
Exemple	DIV(11,2) = 5

### EXP

Syntaxe	`EXP(number)`
Résultat	Nombre
Définition	Renvoie la valeur e élevée à la puissance du `<number>` donné.
Exemple	EXP(2) = 7.389 EXP(-[Growth Rate]*[Time])
Remarques	Voir aussi `LN`.

### FLOOR

Syntaxe	`FLOOR(number)`
Résultat	Entier
Définition	Arrondit un nombre au `<number>` le plus proche de valeur inférieure ou égale.
Exemple	FLOOR(7.9) = 7
Remarques	Voir aussi `CEILING` et `ROUND`.
Limites de la base de données	La valeur `FLOOR` est disponible par l’intermédiaire des connecteurs suivants : Microsoft Excel, Fichier texte, Fichier de statistiques, Source de données publiée, Amazon EMR Hadoop Hive, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

### HEXBINX

Syntaxe	`HEXBINX(number, number)`
Résultat	Nombre
Définition	Mappe des coordonnées x, y sur la coordonnée x de la classe hexagonale la plus proche. Les classes ayant une longueur latérale de 1, il est possible que vous deviez dimensionner les entrées.
Exemple	HEXBINX([Longitude]2.5, [Latitude]2.5)
Remarques	`HEXBINX` et `HEXBINY` sont des fonctions de répartition en classe et de tracé pour des classes hexagonales. Les classes hexagonales offrent un moyen efficace et simple pour visualiser les données dans un plan x/y tel qu’une carte. Du fait que les classes sont hexagonales, chaque classe se rapproche d’un cercle et réduit l’écart de distance entre le point de données et le centre de la classe. Cela permet de rendre le regroupement plus précis et informatif.

### HEXBINY

Syntaxe	`HEXBINY(number, number)`
Résultat	Nombre
Définition	Mappe des coordonnées x, y sur la coordonnée y de la classe hexagonale la plus proche. Les classes ayant une longueur latérale de 1, il est possible que vous deviez dimensionner les entrées.
Exemple	HEXBINY([Longitude]2.5, [Latitude]2.5)
Remarques	Voir aussi `HEXBINX`.

### LN

Syntaxe	`LN(number)`
Résultat	Nombre La sortie est `Null` si l’argument est inférieur ou égal à zéro.
Définition	Renvoie le logarithme naturel d’un `<number>`.
Exemple	LN(50) = 3.912023005
Remarques	Voir aussi `EXP` et `LOG`.

### LOG

Syntaxe	`LOG(number, [base])` S’il n’y a aucun argument de base facultatif, la base 10 est utilisée.
Résultat	Nombre
Définition	Renvoie le logarithme naturel d’un nombre pour la base donnée.
Exemple	LOG(16,4) = 2
Remarques	Voir aussi `POWER` `LN`.

### MAX

Syntaxe	`MAX(expression)` ou `MAX(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données. `MAX` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MAX(4,7) = 7 MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# MAX([Name]) = "Zander"
Remarques	Pour les chaînes La valeur `MAX` vient généralement en dernier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MAX` est la plus élevée dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MAX` est la date la plus récente. Si `MAX` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MAX` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MIN`.

### MIN

Syntaxe	`MIN(expression)` ou `MIN(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur minimale des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MIN(4,7) = 4 MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986# MIN([Name]) = "Abebi"
Remarques	Pour les chaînes La valeur `MIN` vient généralement en premier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MIN` est la plus basse dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MIN` est la date la plus proche. Si `MIN` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MIN` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MAX`.

### PI

Syntaxe	`PI()`
Résultat	Nombre
Définition	Renvoie la constante numérique PI : 3.14159...
Exemple	PI() = 3.14159
Remarques	Utile pour les fonctions trigonométriques dont les données sont exprimées en radians. Voir aussi `RADIANS`.

### POWER

Syntaxe	`POWER(number, power)`
Résultat	Nombre
Définition	Élève le `<number>` à la `<power>` indiquée.
Exemple	POWER(5,3) = 125 POWER([Temperature], 2)
Remarques	Vous pouvez également utiliser le symbole ^, par exemple, `5^3 = POWER(5,3) = 125` Voir aussi `EXP`, `LOG` et `SQUARE`.

### RADIANS

Syntaxe	`RADIANS(number)`
Résultat	Nombre (angle en radians)
Définition	Convertit en radians un `<number>` exprimé en degrés.
Exemple	RADIANS(180) = 3.14159
Remarques	La fonction inverse, `DEGREES`, utilise un angle exprimé en radians et le renvoie en degrés.

### ROUND

Syntaxe	`ROUND(number, [decimals])`
Résultat	Nombre
Définition	Arrondit les `<number>` à un nombre donné de chiffres. L’argument facultatif `decimals` indique le nombre de points décimaux de précision à inclure dans le résultat final. Si la valeur `decimals` n’est pas indiquée, le nombre est arrondi à l’entier le plus proche.
Exemple	ROUND(1/3, 2) = 0.33
Remarques	Certaines bases de données, telles que SQL Server, autorisent l’indication d’une valeur négative, où -1 arrondit les nombres aux dizaines, -2 arrondit aux centaines, etc. Ce n’est pas le cas pour toutes les bases de données. Ce n’est par exemple pas le cas pour Excel ou Access. [!TIP] Conseil : Étant donné que `ROUND` peut rencontrer des problèmes en raison de la représentation sous-jacente des nombres en virgule flottante, comme 9,405 arrondi à 9,40, il peut être préférable de mettre en forme le nombre avec le nombre de décimales souhaité plutôt que d’arrondir. Le formatage de 9,405 à deux décimales donnera le 9,41 attendu. Voir aussi `CEILING` et `FLOOR`.

### SIGN

Syntaxe	`SIGN(number)`
Résultat	-1, 0 ou 1
Définition	Renvoie le signe d’un `<number>` : Les valeurs renvoyées sont -1 si le nombre est négatif, 0 s’il est égal à zéro ou 1 s’il est positif.
Exemple	SIGN(AVG(Profit)) = -1
Remarques	Voir aussi `ABS`.

### SIN

Syntaxe	`SIN(number)` L’argument numérique est l’angle exprimé en radians.
Résultat	Nombre
Définition	Renvoie le sinus d’un angle.
Exemple	SIN(0) = 1.0 SIN(PI( )/4) = 0.707106781186548
Remarques	La fonction inverse, `ASIN`, utilise le sinus comme argument et renvoie l’angle en radians. Voir aussi `PI`. Pour convertir un angle de degrés en radians, utilisez `RADIANS`.

### SQRT

Syntaxe	`SQRT(number)`
Résultat	Nombre
Définition	Renvoie la racine carrée d’un `<number>`.
Exemple	SQRT(25) = 5
Remarques	Voir aussi `SQUARE`.

### SQUARE

Syntaxe	`SQUARE(number)`
Résultat	Nombre
Définition	Renvoie le carré d’un `<number>`.
Exemple	SQUARE(5) = 25
Remarques	Voir aussi `SQRT` et `POWER`.

### TAN

Syntaxe	`TAN(number)` L’argument numérique est l’angle exprimé en radians.
Résultat	Nombre
Définition	Renvoie la tangente d’un angle.
Exemple	TAN(PI ( )/4) = 1.0
Remarques	Voir aussi `ATAN`, `ATAN2`,`COT` et `PI`. Pour convertir un angle de degrés en radians, utilisez `RADIANS`.

### ZN

Syntaxe	`ZN(expression)`
Résultat	Aucun, ou o
Définition	Renvoie l’`<expression>` si celle-ci n’est pas nulle; sinon renvoie la valeur zéro. Utilisez cette fonction pour remplacer les valeurs nulles par des zéros.
Exemple	ZN(Grade) = 0
Remarques	Cette fonction est très utile lors de l’utilisation de champs pouvant contenir des valeurs nulles dans un calcul. En entourant le champ de `ZN`, on évite les erreurs dues au calcul avec des valeurs nulles.

Fonctions de chaîne ### ASCII

Syntaxe	`ASCII(string)`
Résultat	Nombre
Définition	Renvoie le code ASCII du premier caractère d’une `<string>`.
Exemple	ASCII('A') = 65
Remarques	Il s’agit de l’inverse de la fonction `CHAR`.

### CHAR

Syntaxe	`CHAR(number)`
Résultat	Chaîne
Définition	Renvoie le caractère encodé à l’aide du nombre du code ASCII `<number>`.
Exemple	CHAR(65) = 'A'
Remarques	Il s’agit de l’inverse de la fonction `ASCII`.

### CONTAINS

Syntaxe	`CONTAINS(string, substring)`
Résultat	Booléen
Définition	Renvoie TRUE si la chaîne donnée contient la sous-chaîne indiquée.
Exemple	CONTAINS("Calculation", "alcu") = true
Remarques	Voir aussi la fonction logique `IN` ainsi que la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires. Selon la source de données, CONTAINS peut être sensible à la casse. Plus précisément, pour certaines sources de données, `CONTAINS("Calculation", "ALCU") = false` mais `CONTAINS("Calculation", "alcu") = true`. Consultez également UPPER, LOWER et PROPER.

### ENDSWITH

Syntaxe	`ENDSWITH(string, substring)`
Résultat	Booléen
Définition	Renvoie TRUE si la chaîne donnée se termine par la sous-chaîne indiquée. Les espaces en fin de chaîne sont ignorés.
Exemple	ENDSWITH("Tableau", "leau") = true
Remarques	Voir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires.

### FIND

Syntaxe	`FIND(string, substring, [start])`
Résultat	Nombre
Définition	Renvoie la position d’index de la sous-chaîne dans la chaîne, ou 0 si la sous-chaîne est introuvable. Le premier caractère de la chaîne correspond à la position 1. Si l’argument numérique facultatif `start` est ajouté, la fonction ignore les instances de la sous-chaîne qui apparaissent avant la position de début.
Exemple	FIND("Calculation", "alcu") = 2 FIND("Calculation", "Computer") = 0 FIND("Calculation", "a", 3) = 7 FIND("Calculation", "a", 2) = 2 FIND("Calculation", "a", 8) = 0
Remarques	Voir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires.

### FINDNTH

Syntaxe	`FINDNTH(string, substring, occurrence)`
Résultat	Nombre
Définition	Renvoie la position de la nième occurrence de la sous-chaîne dans la chaîne spécifiée, où n est défini par l’argument d’occurrence.
Exemple	FINDNTH("Calculation", "a", 2) = 7
Remarques	`FINDNTH` n’est pas disponible pour toutes les sources de données. Voir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires.

### LEFT

Syntaxe	`LEFT(string, number)`
Résultat	Chaîne
Définition	Renvoie les caractères `<number>` situés le plus à gauche dans la chaîne.
Exemple	LEFT("Matador", 4) = "Mata"
Remarques	Voir également MID et RIGHT.

### LEN

Syntaxe	`LEN(string)`
Résultat	Nombre
Définition	Renvoie la longueur de la chaîne.
Exemple	LEN("Matador") = 7
Remarques	À ne pas confondre avec la fonction spatiale `LENGTH`.

### LOWER

Syntaxe	`LOWER(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie en caractères tout en minuscules.
Exemple	LOWER("ProductVersion") = "productversion"
Remarques	Voir également UPPER et PROPER.

### LTRIM

Syntaxe	`LTRIM(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie en supprimant les espaces de début.
Exemple	LTRIM(" Matador ") = "Matador "
Remarques	Voir également RTRIM.

### MAX

Syntaxe	`MAX(expression)` ou `MAX(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données. `MAX` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MAX(4,7) = 7 MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# MAX([Name]) = "Zander"
Remarques	Pour les chaînes La valeur `MAX` vient généralement en dernier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MAX` est la plus élevée dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MAX` est la date la plus récente. Si `MAX` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MAX` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MIN`.

### MID

Syntaxe	`(MID(string, start, [length])`
Résultat	Chaîne
Définition	Renvoie une chaîne de caractères commençant à la position `start` spécifiée. Le premier caractère de la chaîne correspond à la position 1. Si l’argument numérique facultatif `length` est ajouté, la chaîne renvoyée inclut uniquement ce nombre de caractères.
Exemple	MID("Calculation", 2) = "alculation" MID("Calculation", 2, 5) ="alcul"
Remarques	Voir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires.

### MIN

Syntaxe	`MIN(expression)` ou `MIN(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur minimale des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MIN(4,7) = 4 MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986# MIN([Name]) = "Abebi"
Remarques	Pour les chaînes La valeur `MIN` vient généralement en premier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MIN` est la plus basse dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MIN` est la date la plus proche. Si `MIN` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MIN` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MAX`.

### PROPER

Syntaxe	`PROPER(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie de sorte que la première lettre de chaque mot soit en majuscule et les lettres restantes en minuscules.
Exemple	PROPER("PRODUCT name") = "Product Name" PROPER("darcy-mae") = "Darcy-Mae"
Remarques	Les espaces et les caractères non alphanumériques tels que la ponctuation sont traités comme des séparateurs. Voir également LOWER et UPPER.
Limites de la base de données	PROPER est disponible uniquement pour certains fichiers plats et sous forme d’extraits. Si vous devez utiliser PROPER dans une source de données qui ne la prend par ailleurs pas en charge, envisagez d’utiliser un extrait.

### REPLACE

Syntaxe	`REPLACE(string, substring, replacement`
Résultat	Chaîne
Définition	Recherche la valeur `<string>` pour la valeur `<substring>` et la remplace par `<replacement>`. Si la valeur `<substring>` est introuvable, la chaîne reste inchangée.
Exemple	REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"
Remarques	Voir aussi la fonction `REGEXP_REPLACE` dans la documentation des fonctions supplémentaires.

### RIGHT

Syntaxe	`RIGHT(string, number)`
Résultat	Chaîne
Définition	Renvoie les caractères `<number>` situés le plus à droite dans la chaîne.
Exemple	RIGHT("Calculation", 4) = "tion"
Remarques	Voir également LEFT et MID.

### RTRIM

Syntaxe	`RTRIM(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie en supprimant les espaces de fin.
Exemple	RTRIM(" Calculation ") = " Calculation"
Remarques	Voir également LTRIM et TRIM.

### SPACE

Syntaxe	`SPACE(number)`
Résultat	Chaîne (en particulier, juste des espaces)
Définition	Renvoie une chaîne constituée du nombre spécifié d’espaces répétés.
Exemple	SPACE(2) = " "

### SPLIT

Syntaxe	`SPLIT(string, delimiter, token number)`
Résultat	Chaîne
Définition	Renvoie une sous-chaîne à partir d’une chaîne, à l’aide d’un caractère délimiteur pour diviser la chaîne en une séquence de jetons.
Exemple	SPLIT ("a-b-c-d", "-", 2) = "b" SPLIT ("a\|b\|c\|d", "\|", -2) = "c"
Remarques	La chaîne est interprétée comme une séquence alternative de délimiteurs et jetons. Ainsi, pour la chaîne `abc-defgh-i-jkl`, où le délimiteur est le caractère ‘`-`’, les jetons sont (1) `abc`, (2) `defgh`, (3) `i` et (4) `jlk`. `SPLIT` renvoie le jeton correspondant au numéro du jeton. Lorsque le numéro de jeton est positif, les jetons sont comptabilisés à partir de l’extrémité gauche de la chaîne; si le numéro de jeton est négatif, les jetons sont comptabilisés à partir de la droite. Voir aussi la fonction REGEX prise en charge dans la documentation des fonctions supplémentaires.
Limites de la base de données	Les commandes Fractionnement et Fractionnement personnalisé sont disponibles pour les types de sources de données suivants : extraits de données Tableau, Microsoft Excel, fichier texte, fichier PDF, Salesforce, Protocole de données ouvertes, Microsoft Azure Market Place, Google Analytics, Vertica, Oracle, MySQL, PostgreSQL, Teradata, Amazon Redshift, Aster Data, Google Big Query, Cloudera Hadoop Hive, Hortonworks Hive et Microsoft SQL Server. Certaines sources de données imposent des limites au fractionnement des chaînes. Consultez les limites de la fonction SPLIT plus loin dans cette rubrique.

### STARTSWITH

Syntaxe	`STARTSWITH(string, substring)`
Résultat	Booléen
Définition	Renvoie true si `string` commence par `substring`. Les espaces en début de chaîne sont ignorés.
Exemple	STARTSWITH("Matador, "Ma") = TRUE
Remarques	Voir aussi CONTAINS, ainsi que la fonction REGEX prise en charge dans la documentation des fonctions supplémentaires.

### TRIM

Syntaxe	`TRIM(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie en supprimant les espaces de début et de fin.
Exemple	TRIM(" Calculation ") = "Calculation"
Remarques	Voir également LTRIM et RTRIM.

### UPPER

Syntaxe	`UPPER(string)`
Résultat	Chaîne
Définition	Renvoie la `<string>` fournie en caractères tout en majuscules.
Exemple	UPPER("Calculation") = "CALCULATION"
Remarques	Voir également PROPER et LOWER.

Fonctions de date **Remarque :** Les fonctions de date ne prennent pas en considération le début de l’exercice financier configuré. Voir [Dates fiscales](https://help.tableau.com/current/pro/desktop/fr-ca/dates_fiscal.htm) ### DATE Fonction de conversion de type qui transforme les expressions de chaînes et de nombres en dates, tant qu’elles sont dans un format reconnaissable.

Syntaxe	`DATE(expression)`
Résultat	Date
Définition	Renvoie une date en fonction d’un nombre, d’une chaîne ou d’une `<expression>`de date.
Exemple	DATE([Employee Start Date]) DATE("September 22, 2018") DATE("9/22/2018") DATE(#2018-09-22 14:52#)
Remarques	Contrairement à `DATEPARSE`, il n’est pas nécessaire de fournir une tendance car `DATE` reconnaît automatiquement de nombreux formats de date standard. Si toutefois `DATE` ne reconnaît pas l’entrée, essayez d’utiliser `DATEPARSE` et de préciser le format. `MAKEDATE` est une autre fonction similaire, mais `MAKEDATE` nécessite la saisie de valeurs numériques pour l’année, le mois et le jour.

### DATEADD Ajoute un nombre spécifié de parties de date (mois, jours, etc.) à la date de début.

Syntaxe	`DATEADD(date_part, interval, date)`
Résultat	Date
Définition	Renvoie la `<date>` spécifiée avec le numéro spécifié `<interval>` ajouté à l’élément `<date_part>` spécifié de cette date. Par exemple, le fait d’ajouter trois mois ou 12 jours à une date de début.
Exemple	Reporter toutes les dates d’échéance d’une semaine DATEADD('week', 1, [due date]) Ajouter 280 jours à la date du 20 février 2021 DATEADD('day', 280, #2/20/21#) = #November 27, 2021#
Remarques	Prend en charge les dates ISO 8601.

### DATEDIFF Renvoie le nombre de parties de date (semaines, années, etc.) entre deux dates.

Syntaxe	`DATEDIFF(date_part, date1, date2, [start_of_week])`
Résultat	Entier
Définition	Renvoie la différence entre `<date1>` et `<date2>` exprimée en unités de `<date_part>`. Par exemple, le fait de soustraire les dates auxquelles une personne a intégré ou quitté un groupe pour déterminer le temps passé au sein du groupe.
Exemple	Nombre de jours entre le 25 mars 1986 et le 20 février 2021 DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751 Nombre de mois qu’une personne a passé dans un groupe DATEDIFF('month', [date joined band], [date left band])
Remarques	Prend en charge les dates ISO 8601.

### DATENAME Renvoie le nom de la partie de date spécifiée sous la forme d’une chaîne discrète.

Syntaxe	`DATENAME(date_part, date, [start_of_week])`
Résultat	Chaîne
Définition	Renvoie `<date_part>` de `<date>` sous la forme d’une chaîne.
Exemple	DATENAME('year', #3/25/1986#) = "1986" DATENAME('month', #1986-03-25#) = "March"
Remarques	Prend en charge les dates ISO 8601. Un calcul très similaire est DATEPART, qui renvoie la valeur de la partie de date spécifiée sous la forme d’un entier continu. `DATEPART` peut être plus rapide, car il s’agit d’une opération numérique. En modifiant les attributs du résultat du calcul (dimension ou mesure, continu ou discret) et la mise en forme de la date, les résultats de `DATEPART` et `DATENAME` peuvent être mis en forme pour être identiques. DATEPARSE est une fonction inverse qui prend une valeur de chaîne et la met sous la forme d’une date.

### DATEPARSE Renvoie des chaînes de caractères spécifiquement mises en forme sous la forme de dates.

Syntaxe	`DATEPARSE(date_format, date_string)`
Résultat	Date
Définition	L’argument `<date_format>` décrit comment le champ `<date_string>` est disposé. Étant donné que le champ de type chaîne peut être disposé de multiples manières, `<date_format>` doit correspondre exactement. Pour une explication complète et des explications détaillées sur la mise en forme, consultez Convertir un champ en un champ de date.
Exemple	DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#
Remarques	`DATE` est une fonction similaire qui reconnaît automatiquement de nombreux formats de date standard. `DATEPARSE` est une option idéale si `DATE` ne reconnaît pas le modèle d’entrée. `MAKEDATE` est une autre fonction similaire, mais `MAKEDATE` nécessite la saisie de valeurs numériques pour l’année, le mois et le jour. Les fonctions inverses, qui séparent les dates et renvoient la valeur de leurs parties, sont `DATEPART` (sortie de l’entier) et `DATENAME` (sortie de chaîne de caractères).
Limites de la base de données	`DATEPARSE` est disponible dans les connecteurs suivants : connexions aux fichiers Excel et texte non hérités, Amazon EMR Hadoop Hive, Cloudera Hadoop, Google Sheets, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL et extraits Tableau. Certains formats peuvent ne pas être disponibles pour toutes les connexions. `DATEPARSE` n’est pas pris en charge sur les variantes Hive. Seuls Denodo, Drill et Snowflake sont pris en charge.

### DATEPART Renvoie le nom d’une date donnée sous la forme d’un nombre entier.

Syntaxe	`DATEPART(date_part, date, [start_of_week])`
Résultat	Entier
Définition	Renvoie `<date_part>` de `<date>` sous la forme d’un nombre entier.
Exemple	DATEPART('year', #1986-03-25#) = 1986 DATEPART('month', #1986-03-25#) = 3
Remarques	Prend en charge les dates ISO 8601. Un calcul très similaire est `DATENAME`, qui renvoie le nom de la partie de date spécifiée sous la forme d’une chaîne discrète. `DATEPART` peut être plus rapide, car il s’agit d’une opération numérique. En modifiant les attributs du champ (dimension ou mesure, continu ou discret) et la mise en forme de la date, les résultats de `DATEPART` et `DATENAME` peuvent être mis en forme pour être identiques. `DATEPARSE` est une fonction inverse qui prend une valeur de chaîne et la met sous la forme d’une date.

### DATETRUNC Cette fonction peut être considérée comme un arrondi de date. Elle prend une date spécifique et renvoie une version de cette date avec la précision souhaitée. Étant donné que chaque date doit avoir une valeur pour le jour, le mois, le trimestre et l’année, `DATETRUNC` définit la valeur la plus faible pour chaque partie de date jusqu’à la partie de date spécifiée. Consultez l’exemple pour plus d’information.

Syntaxe	`DATETRUNC(date_part, date, [start_of_week])`
Résultat	Date
Définition	Tronque la `<date>` au niveau indiqué par la valeur `<date_part>`. Cette fonction renvoie une nouvelle date. Par exemple, lorsque vous tronquez une date qui se situe au milieu du mois au niveau mois, cette fonction renvoie le premier jour du mois.
Exemple	DATETRUNC('day', #9/22/2018#) = #9/22/2018# DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018# (le lundi de la semaine sur lequel tombe le 22/09/2018) DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# (le premier jour du trimestre sur lequel tombe le 22/09/2018) Remarque : pour la semaine et la valeur iso-week, le `start_of_week` est pris en considération. La valeur ISO-8601 commence toujours le lundi. Pour les paramètres régionaux de cet exemple, une valeur `start_of_week` non spécifiée indique que le début de la semaine est un dimanche.
Remarques	Prend en charge les dates ISO 8601. Vous ne devez pas utiliser `DATETRUNC` pour, par exemple, cesser d’afficher l’heure d’un champ de date dans une visualisation. Si vous souhaitez tronquer l’affichage d’une date plutôt que d’arrondir sa précision, ajustez la mise en forme. Par exemple, si `DATETRUNC('day', #5/17/2022 3:12:48 PM#)` est mis en forme dans la visualisation pour s’afficher avec des secondes, il sera affiché comme étant `5/17/2022 12:00:00 AM`. La valeur est tronquée au jour, mais l'affichage passe aux secondes.

### DAY Renvoie le jour du mois (1- 31) sous la forme d’un entier.

Syntaxe	`DAY(date)`
Résultat	Entier
Définition	Renvoie le jour d’une `<date>` donnée sous la forme d’un entier.
Exemple	Day(#September 22, 2018#) = 22
Remarques	Voir aussi `WEEK`, `MONTH`, `QUARTER`, `YEAR` et les équivalents ISO.

### ISDATE Vérifie si la chaîne est un format de date valide.

Syntaxe	`ISDATE(string)`
Résultat	Booléen
Définition	Renvoie la valeur true si une `<string>` donnée est une date valide.
Exemple	ISDATE(09/22/2018) = true ISDATE(22SEP18) = false
Remarques	L’argument requis doit être une chaîne. ISDATE ne doit pas être utilisé pour un champ dont le type de données est une date : le calcul renverra une erreur.

### ISOQUARTER

Syntaxe	`ISOQUARTER(date)`
Résultat	Entier
Définition	Renvoie le trimestre ISO8601 basé sur les semaines d’une `<date>` donnée sous la forme d’un entier.
Exemple	ISOQUARTER(#1986-03-25#) = 1
Remarques	Consultez aussi `ISOWEEK`, `ISOWEEKDAY`, `ISOYEAR` et leurs équivalents non ISO.

### ISOWEEK

Syntaxe	`ISOWEEK(date)`
Résultat	Entier
Définition	Renvoie la semaine ISO8601 basée sur les semaines d’une `<date>` donnée sous la forme d’un entier.
Exemple	ISOWEEK(#1986-03-25#) = 13
Remarques	Consultez aussi `ISOWEEKDAY`, `ISOQUARTER`, `ISOYEAR` et leurs équivalents non ISO.

### ISOWEEKDAY

Syntaxe	`ISOWEEKDAY(date)`
Résultat	Entier
Définition	Renvoie le jour de la semaine ISO8601 basé sur les semaines d’une `<date>` donnée sous la forme d’un entier.
Exemple	ISOWEEKDAY(#1986-03-25#) = 2
Remarques	Consultez aussi `ISOWEEK`, `ISOQUARTER`, `ISOYEAR` et leurs équivalents non ISO.

### ISOYEAR

Syntaxe	`ISOYEAR(date)`
Résultat	Entier
Définition	Renvoie l’année ISO8601 basée sur les semaines d’une `<date>` donnée sous la forme d’un entier.
Exemple	ISOYEAR(#1986-03-25#) = 1,986
Remarques	Consultez aussi `ISOWEEK`, `ISOWEEKDAY`, `ISOQUARTER` et leurs équivalents non ISO.

### MAKEDATE

Syntaxe	`MAKEDATE(year, month, day)`
Résultat	Date
Définition	Renvoie une valeur de date créée à partir de l’`<year>`, du `<month>` et du `<day>` spécifiés.
Exemple	MAKEDATE(1986,3,25) = #1986-03-25#
Remarques	Remarque : Les valeurs erronées seront corrigées dans une date, par exemple `MAKEDATE(2020,4,31) = May 1, 2020` au lieu de renvoyer une erreur qui indique que le mois d’avril n’a pas 31 jours. Disponible pour les extraits de données Tableau. Vérifiez la disponibilité dans d’autres sources de données. `MAKEDATE` a besoin d’entrées numériques pour les parties d’une date. Si vos données sont une chaîne qui doit être une date, essayez la fonction `DATE`. `DATE` reconnaît automatiquement de nombreux formats de date standard. Si `DATE` ne reconnaît pas l’entrée, essayez d’utiliser `DATEPARSE`.

### MAKEDATETIME

Syntaxe	`MAKEDATETIME(date, time)`
Résultat	Datetime
Définition	Renvoie des données date/heure composées d’une `<date>` et d’une `<time>`. La date peut être une information de type date, date/heure ou chaîne. L’heure doit être une information de type date/heure.
Exemple	MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM# MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#
Remarques	Cette fonction est disponible uniquement pour les connexions compatibles MySQL (pour Tableau, MySQL et Amazon Aurora). `MAKETIME` est une fonction similaire disponible pour les extraits de données Tableau et certaines autres sources de données.

### MAKETIME

Syntaxe	`MAKETIME(hour, minute, second)`
Résultat	Datetime
Définition	Renvoie une valeur de date créée à partir de l’`<hour>`, du `<minute>` et du `<second>` spécifiés.
Exemple	MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#
Remarques	Comme Tableau ne prend pas en charge le type de données heure, mais seulement le type date-heure, la sortie est une valeur datetime. La partie date du champ sera 1/1/1899. Fonction similaire à `MAKEDATETIME`, disponible uniquement pour les connexions compatibles avec MYSQL.

### MAX

Syntaxe	`MAX(expression)` ou `MAX(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données. `MAX` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MAX(4,7) = 7 MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# MAX([Name]) = "Zander"
Remarques	Pour les chaînes La valeur `MAX` vient généralement en dernier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MAX` est la plus élevée dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MAX` est la date la plus récente. Si `MAX` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MAX` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MIN`.

### MIN

Syntaxe	`MIN(expression)` ou `MIN(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur minimale des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MIN(4,7) = 4 MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986# MIN([Name]) = "Abebi"
Remarques	Pour les chaînes La valeur `MIN` vient généralement en premier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MIN` est la plus basse dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MIN` est la date la plus proche. Si `MIN` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MIN` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MAX`.

### MONTH

Syntaxe	`MONTH(date)`
Résultat	Entier
Définition	Renvoie le mois d’une `<date>` donnée sous la forme d’un entier.
Exemple	MONTH(#1986-03-25#) = 3
Remarques	Voir aussi `DAY`, `WEEK`, `QUARTER`, `YEAR` et les équivalents ISO

### NOW

Syntaxe	`NOW()`
Résultat	Datetime
Définition	Renvoie la date et l’heure actuelles du système local.
Exemple	NOW() = 1986-03-25 1:08:21 PM
Remarques	`NOW` n’utilise pas un argument. Consultez aussi `TODAY`, un calcul similaire qui renvoie une date plutôt qu’un élément datetime. Si la source de données est une connexion en direct, la date et l’heure du système peuvent indiquer un autre fuseau horaire. Pour plus d’information sur la résolution de ce problème, consultez la base de connaissances.

### QUARTER

Syntaxe	`QUARTER(date)`
Résultat	Entier
Définition	Renvoie le trimestre d’une `<date>` donnée sous la forme d’un entier.
Exemple	QUARTER(#1986-03-25#) = 1
Remarques	Voir aussi `DAY`, `WEEK`, `MONTH`, `YEAR` et les équivalents ISO

### TODAY

Syntaxe	`TODAY()`
Résultat	Date
Définition	Renvoie la date actuelle du système local.
Exemple	TODAY() = 1986-03-25
Remarques	`TODAY` n’utilise pas un argument. Consultez aussi NOW, un calcul similaire qui renvoie une valeur datetime plutôt qu’une date. Si la source de données est une connexion en direct, la date du système peut indiquer un autre fuseau horaire. Pour plus d’information sur la résolution de ce problème, consultez la base de connaissances.

### WEEK

Syntaxe	`WEEK(date)`
Résultat	Entier
Définition	Renvoie la semaine d’une `<date>` donnée sous la forme d’un entier.
Exemple	WEEK(#1986-03-25#) = 13
Remarques	Voir aussi `DAY`, `MONTH`, `QUARTER`, `YEAR` et les équivalents ISO

### YEAR

Syntaxe	`YEAR(date)`
Résultat	Entier
Définition	Renvoie l’année d’une `<date>` donnée sous la forme d’un entier.
Exemple	YEAR(#1986-03-25#) = 1,986
Remarques	Voir aussi `DAY`, `WEEK`, `MONTH`, `QUARTER` et les équivalents ISO

## date\_part Plusieurs fonctions de date dans Tableau utilisent l’argument `date_part`, une chaîne constante qui demande à la fonction la partie d’une date à considérer, par exemple le jour, la semaine, le trimestre, etc. Les valeurs `date_part` valides que vous pouvez utiliser sont les suivantes : | date\_part | Valeurs | | --- | --- | | `'year'` | Année exprimée à l’aide de quatre chiffres | | `'quarter'` | 1 à 4 | | `'month'` | 1 à 12, ou « janvier », « février », etc. | | `'dayofyear'` | Jour de l’année; 1 correspond au 1er janvier, 32 correspond au 1er février, etc. | | `'day'` | 1 à 31 | | `'weekday'` | 1 à 7, ou « dimanche », « lundi », etc. | | `'week'` | 1 à 52 | | `'hour'` | 0 à 23 | | `'minute'` | 0 à 59 | | `'second'` | 0 à 60 | | `'iso-year'` | Année ISO 8601 à quatre chiffres | | `'iso-quarter'` | 1 à 4 | | `'iso-week'` | 1 à 52, le début de la semaine est toujours un lundi | | `'iso-weekday'` | 1 à 7, le début de la semaine est toujours un lundi | Fonctions logiques ### AND

Syntaxe	`<expr1> AND <expr2>`
Définition	Conjonction logique entre deux expressions. (Si les deux expressions sont définies sur vrai, le test logique renvoie un résultat positif.)
Résultat	Booléen(vrai ou faux)
Exemple	IF [Season] = "Spring" AND "[Season] = "Fall" THEN "It's the apocalypse and footwear doesn't matter" END « Si les expressions (Saison = Printemps) et (Saison = Automne) sont simultanément vraies, C’est l’apocalypse et les chaussures n’ont pas d’importance est retournée. »
Remarques	Souvent utilisé avec IF et IIF. Voir également NOT et OU. Si les deux expressions sont `TRUE` (c’est-à-dire qu’elles ne sont pas `FALSE` ou `NULL`), le résultat est `TRUE`. Si l’une des expressions est `NULL`, le résultat est `NULL`. Dans tous les autres cas, le résultat obtenu est `FALSE`. Si vous créez un calcul dans lequel le résultat d’une comparaison `AND` s’affiche dans une feuille de calcul, Tableau affiche les valeurs `TRUE` et `FALSE`. Si vous voulez modifier cela, utilisez la zone de mise en forme dans la boîte de dialogue Mettre en forme. Remarque : L’opérateur `AND` utilise l’évaluation de court-circuit. Cela signifie que si la première expression est évaluée comme étant `FALSE`, la seconde expression n’est pas du tout évaluée. Cela peut être utile si la seconde expression renvoie une erreur lorsque la première expression est `FALSE`, car dans ce cas-là, la seconde expression n’est jamais évaluée.

### CASE

Syntaxe	`CASE <expression> WHEN <value1> THEN <then1> WHEN <value2> THEN <then2> ... [ELSE <default>] END`
Résultat	Dépend du type de données des valeurs `<then>`.
Définition	Évalue l’`expression` et la compare aux options spécifiées (`<value1>`, `<value2>`, etc.). Lorsqu’une `value` correspondant à l’expression est appliquée, CASE renvoie la valeur de `return` correspondante. Si aucune correspondance n’est trouvée, la valeur par défaut (facultatif) est retournée. Si aucune valeur par défaut ni aucune valeur ne correspond, la valeur nulle est renvoyée.
Exemple	`CASE [Season] WHEN 'Summer' THEN 'Sandals' WHEN 'Winter' THEN 'Boots' ELSE 'Sneakers' END` « Regardez le champ Saison. Si la valeur est Été, Sandales est retourné. Si la valeur est Hiver, Bottes est retourné. Si aucune des options du calcul ne correspond à ce qui est indiqué dans le champ Saison, chaussures de sport est retourné. »
Remarques	Voir également IF et IIF. Utilisé avec les expressions WHEN, THEN, ELSE et END. [!TIP] Conseil : Il est souvent possible d’utiliser un groupe pour obtenir les mêmes résultats qu’une fonction CASE complexe, ou d’utiliser CASE pour remplacer la fonctionnalité de regroupement native, comme dans l’exemple précédent. Vous voudrez peut-être tester lequel est le plus performant pour votre scénario.

### ELSE

Syntaxe	`CASE <expression> WHEN <value1> THEN <then1> WHEN <value2> THEN <then2> ... [ELSE <default>] END`
Définition	Élément facultatif d’une expression `IF` ou `CASE` utilisée pour préciser une valeur par défaut à renvoyer si aucune des expressions testées n’est vraie.
Exemple	IF [Season] = "Summer" THEN 'Sandals' ELSEIF [Season] = "Winter" THEN 'Boots' ELSE 'Sneakers' END CASE [Season] WHEN 'Summer' THEN 'Sandals' WHEN 'Winter' THEN 'Boots' ELSE 'Sneakers' END
Remarques	Utilisé avec les expressions CASE, WHEN, IF, ELSEIF, THEN et END `ELSE` est facultatif avec `CASE` et `IF`. Dans un calcul où `ELSE` n’est pas précisé, si aucune valeur `<test>` n’est true, le calcul global renvoie une valeur nulle. `ELSE` ne requiert aucune condition (par exemple, `[Season] = "Winter"`) et peut être considéré comme une forme de traitement des valeurs nulles.

### ELSEIF

Syntaxe	`[ELSEIF <test2> THEN <then2>]`
Définition	Élément facultatif d’une expression `IF` utilisée pour préciser des conditions supplémentaires au-delà de l’expression IF initiale.
Exemple	IF [Season] = "Summer" THEN 'Sandals' ELSEIF [Season] = "Winter" THEN 'Boots' ELSEIF [Season] = "Spring" THEN 'Sneakers' ELSEIF [Season] = "Autumn" THEN 'Sneakers' ELSE 'Bare feet' END
Remarques	Utilisé avec les expressions IF, THEN, ELSE et END `ELSEIF` peut être considéré comme une clause `IF` supplémentaire. `ELSEIF` est facultatif et peut être répété de nombreuses fois. Contrairement à `ELSE`, `ELSEIF` requiert une condition (par exemple, `[Season] = "Winter"`).

### END

Définition Utilisé pour fermer une expression IF ou CASE.

Exemple

IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots' 
ELSE 'Sneakers' 
END

« Si Saison = Été, Sandales est retourné. Sinon, regardez l’expression suivante. Si Saison = Hiver, Bottes est retourné. Si aucune des expressions n’est vraie, Chaussures de sport est retourné. »

CASE [Season] 
WHEN 'Summer' THEN 'Sandals' 
WHEN 'Winter' THEN 'Boots' 
ELSE 'Sneakers' 
END

« Regardez le champ Saison. Si la valeur est Été, Sandales est retourné. Si la valeur est Hiver, Bottes est retourné. Si aucune des options du calcul ne correspond à ce qui est indiqué dans le champ Saison, chaussures de sport est retourné. »

Remarques

Utilisé avec les expressions CASE, WHEN, IF, ELSEIF, THEN et ELSE

### IF

Syntaxe	`IF <test1> THEN <then1> [ELSEIF <test2> THEN <then2>...] [ELSE <default>] END`
Résultat	Dépend du type de données des valeurs `<then>`.
Définition	Teste une série d’expressions et renvoie la valeur `<then>` pour le premier `<test>` positif.
Exemple	IF [Season] = "Summer" THEN 'Sandals' ELSEIF [Season] = "Winter" THEN 'Boots' ELSE 'Sneakers' END « Si Saison = Été, Sandales est retourné. Sinon, regardez l’expression suivante. Si Saison = Hiver, Bottes est retourné. Si aucune des expressions n’est vraie, Chaussures de sport est retourné. »
Remarques	Voir également IF et IIF. Utilisé avec les expressions ELSEIF, THEN, ELSE et END

### IFNULL

Syntaxe	`IFNULL(expr1, expr2)`
Résultat	Dépend du type de données des valeurs `<expr>`.
Définition	Renvoie `<expr1>` si celle-ci n’est pas nulle, sinon renvoie `<expr2>`.
Exemple	IFNULL([Assigned Room], "TBD") « Si le champ Salle assignée n’est pas une valeur nulle, renvoie sa valeur. Si le champ Salle assignée est une valeur nulle, renvoie plutôt TBD. »
Remarques	Comparez avec ISNULL. `IFNULL` renvoie toujours une valeur. `ISNULL` renvoie un booléen (vrai ou faux). Voir également ZN.

### IIF

Syntaxe	`IIF(<test>, <then>, <else>, [<unknown>])`
Résultat	Dépend du type de données des valeurs de l’expression.
Définition	Vérifie si une condition est remplie (`<test>`), et renvoie `<then>`si le test est positif, `<else>` si le test est négatif, et une valeur facultative pour `<unknown>` si le test est une valeur nulle. Si la valeur inconnue facultative n’est pas précisée, `IIF` renvoie une valeur nulle.
Exemple	IIF([Season] = 'Summer', 'Sandals', 'Other footwear') « Si Saison = Été, Sandales est retourné. Dans le cas contraire, renvoie Autres chaussures » IIF([Season] = 'Summer', 'Sandals', IIF('Season' = 'Winter', 'Boots', 'Other footwear') ) « Si Saison = Été, Sandales est retourné. Sinon, regardez l’expression suivante. Si Saison = Hiver, Bottes est retourné. Si aucune n’est vraie, Chaussures de sport est retourné. » IIF('Season' = 'Summer', 'Sandals', IIF('Season' = 'Winter', 'Boots', IIF('Season' = 'Spring', 'Sneakers', 'Other footwear') ) ) « Si Saison = Été, Sandales est retourné. Sinon, regardez l’expression suivante. Si Saison = Hiver, Bottes est retourné. Si aucune des expressions n’est vraie, Chaussures de sport est retourné. »
Remarques	Voir également IF etCASE. `IIF` n’a pas d’équivalent à `ELSEIF` (comme `IF`) ou aux clauses `WHEN` répétées (comme `CASE`). Au lieu de cela, plusieurs tests peuvent être évalués de manière séquentielle en imbriquant des instructions `IIF` sous la forme de l’élément `<unknown>`. La première valeur positive (la plus extrême) est renvoyée. Autrement dit, dans le calcul ci-dessous, le résultat sera Rouge, et non Orange, car l’expression cesse d’être évaluée dès que A=A est évaluée comme étant positif : `IIF('A' = 'A', 'Red', IIF('B' = 'B', 'Orange', IIF('C' = 'D', 'Yellow', 'Green')))`

### IN

Syntaxe	`<expr1> IN <expr2>`
Résultat	Booléen(vrai ou faux)
Définition	Renvoie `TRUE` si une valeur dans `<expr1>` correspond à une valeur dans `<expr2>`.
Exemple	SUM([Cost]) IN (1000, 15, 200) « La valeur du champ Coût est-elle 1 000, 15 ou 200? » [Field] IN [Set] « La valeur du champ est-elle présente dans l’ensemble? »
Remarques	Les valeurs dans `<expr2>` peuvent être un ensemble, une liste de valeurs littérales ou un champ combiné. Voir également WHEN.

### ISDATE

Syntaxe	`ISDATE(string)`
Résultat	Booléen(vrai ou faux)
Définition	Renvoie la valeur true si une `<string>` est une date valide. L’expression d’entrée doit être un champ de chaîne (texte).
Exemple	ISDATE("2018-09-22") « La chaîne 2018-09-22 est-elle une date correctement mise en forme? »
Remarques	Une date sera considérée comme valide en fonction des paramètres régionaux du système qui évalue le calcul. Par exemple : Aux États-Unis : `ISDATE("2018-09-22") = TRUE` `ISDATE("2018-22-09") = FALSE` Au Royaume-Uni : `ISDATE("2018-09-22") = FALSE` `ISDATE("2018-22-09") = TRUE`

### ISNULL

Syntaxe	`ISNULL(expression)`
Résultat	Booléen(vrai ou faux)
Définition	Renvoie la valeur true si l’`<expression>` est une valeur nulle (ne contient pas de données valides)
Exemple	ISNULL([Assigned Room]) « Le champ Pièce assignée est-il une valeur nulle? »
Remarques	Comparez avec IFNULL. `IFNULL` renvoie toujours une valeur. `ISNULL` renvoie une valeur booléenne. Voir également ZN.

### MAX

Syntaxe	`MAX(expression)` ou `MAX(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données. `MAX` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MAX(4,7) = 7 MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# MAX([Name]) = "Zander"
Remarques	Pour les chaînes La valeur `MAX` vient généralement en dernier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MAX` est la plus élevée dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MAX` est la date la plus récente. Si `MAX` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MAX` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MIN`.

### MIN

Syntaxe	`MIN(expression)` ou `MIN(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur minimale des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MIN(4,7) = 4 MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986# MIN([Name]) = "Abebi"
Remarques	Pour les chaînes La valeur `MIN` vient généralement en premier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MIN` est la plus basse dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MIN` est la date la plus proche. Si `MIN` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MIN` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MAX`.

### NOT

Syntaxe	`NOT <expression>`
Résultat	Booléen(vrai ou faux)
Définition	Négation logique entre deux expressions.
Exemple	IF NOT [Season] = "Summer" THEN 'Don't wear sandals' ELSE 'Wear sandals' END « Si Saison ne correspond pas à Été, retourne Ne portez pas de sandales. Dans le cas contraire, retourne Portez des sandales. »
Remarques	Souvent utilisé avec IF et IIF. Voir également DATE et OU.

### OU

Syntaxe	`<expr1> OR <expr2>`
Résultat	Booléen(vrai ou faux)
Définition	Disjonction logique entre deux expressions.
Exemple	IF [Season] = "Spring" OR [Season] = "Fall" THEN "Sneakers" END « Si (Saison = Printemps) ou (Saison = Automne) est une valeur true, Chaussures de sport est retourné. »
Remarques	Souvent utilisé avec IF et IIF. Voir également DATE et NOT. Si l’une des expressions est `TRUE`, le résultat est `TRUE`. Si les deux expressions sont `FALSE`, le résultat est `FALSE`. Si les deux expressions sont `NULL`, le résultat est `NULL`. Si vous créez un calcul qui affiche le résultat d’une comparaison `OR` dans une feuille de calcul, Tableau affiche les valeurs TRUE et FALSE. Si vous voulez modifier cela, utilisez la zone de mise en forme dans la boîte de dialogue Mettre en forme. Remarque : L’opérateur `OR` utilise l’évaluation de court-circuit. Cela signifie que si la première expression est évaluée comme étant `TRUE`, la seconde expression n’est pas du tout évaluée. Cela peut être utile si la seconde expression renvoie une erreur lorsque la première expression est `TRUE`, car dans ce cas-là, la seconde expression n’est jamais évaluée.

### THEN

Syntaxe	`IF <test1> THEN <then1> [ELSEIF <test2> THEN <then2>...] [ELSE <default>] END`
Définition	Partie obligatoire d’une expression `IF`, `ELSEIF`, ou `CASE`, utilisée pour définir le résultat à renvoyer si une valeur ou un test spécifique est true.
Exemple	IF [Season] = "Summer" THEN 'Sandals' ELSEIF [Season] = "Winter" THEN 'Boots' ELSE 'Sneakers' END « Si Saison = Été, Sandales est retourné. Sinon, regardez l’expression suivante. Si Saison = Hiver, Bottes est retourné. Si aucune des expressions n’est vraie, Chaussures de sport est retourné. » CASE [Season] WHEN 'Summer' THEN 'Sandals' WHEN 'Winter' THEN 'Boots' ELSE 'Sneakers' END « Regardez le champ Saison. Si la valeur est Été, Sandales est retourné. Si la valeur est Hiver, Bottes est retourné. Si aucune des options du calcul ne correspond à ce qui est indiqué dans le champ Saison, chaussures de sport est retourné. »
Remarques	Utilisé avec CASE, WHEN, IF, ELSEIF, THEN, ELSE et END

### WHEN

Syntaxe	`CASE <expression> WHEN <value1> THEN <then1> WHEN <value2> THEN <then2> ... [ELSE <default>] END`
Définition	Partie obligatoire d’une expression `CASE`. Trouve la première `<value>` correspondant à `<expression>` et renvoie la valeur `<then>` correspondante.
Exemple	CASE [Season] WHEN 'Summer' THEN 'Sandals' WHEN 'Winter' THEN 'Boots' ELSE 'Sneakers' END « Regardez le champ Saison. Si la valeur est Été, Sandales est retourné. Si la valeur est Hiver, Bottes est retourné. Si aucune des options du calcul ne correspond à ce qui est indiqué dans le champ Saison, chaussures de sport est retourné. »
Remarques	Utilisé avec les expressions CASE, THEN, ELSE et END. `CASE` prend également en charge les constructions de type `WHEN IN`, par exemple : CASE <expression> WHEN IN <set1> THEN <then1> WHEN IN <combinedfield> THEN <then2> ... ELSE <default> END Les valeurs auxquelles se compare `WHEN IN` doivent être un ensemble, une liste de valeurs littérales ou un champ combiné. Voir également IN.

### ZN

Syntaxe	`ZN(expression)`
Résultat	Dépend du type de données de l’`<expression>` ou de la valeur 0.
Définition	Renvoie <expression> si la valeur n’est pas nulle, sinon renvoie zéro.
Exemple	ZN([Test Grade]) « Si la note de test n’est pas une valeur nulle, renvoie sa valeur. Si la note de test est une valeur nulle, renvoie 0. »
Remarques	La fonction `ZN` est un cas spécifique de l’expression IFNULL qui renvoie toujours 0 si l’expression est une valeur nulle, au lieu de la valeur spécifiée dans le calcul. `ZN` est particulièrement utile lorsqu’on effectue des calculs supplémentaires et qu’une valeur nulle rendrait l’ensemble du calcul nul. Toutefois, il convient d’interpréter ces résultats avec prudence, car une valeur nulle n’est pas toujours synonyme de 0 et peut représenter des données manquantes. Consultez également l’expression ISNULL.

Fonctions d’agrégation ### ATTR

Syntaxe	`ATTR(expression)`
Définition	Renvoie la valeur de l’expression si cette valeur est unique pour toutes les lignes. Dans le cas contraire, la valeur renvoyée est Null. Les valeurs nulles sont ignorées.

### AVG

Syntaxe	`AVG(expression)`
Définition	Renvoie la moyenne de toutes les valeurs de l’expression. Les valeurs nulles sont ignorées.
Remarques	La valeur `AVG` peut être utilisée uniquement avec des champs numériques.

### COLLECT

Syntaxe	`COLLECT(spatial)`
Définition	Un calcul agrégé combinant les valeurs dans le champ d’argument. Les valeurs nulles sont ignorées.
Remarques	La valeur `COLLECT` peut être utilisée uniquement avec des champs de données spatiales.

### CORR

Syntaxe	`CORR(expression1, expression2)`
Résultat	Nombre de -1 à 1
Définition	Renvoie le coefficient de corrélation Pearson de deux expressions.
Exemple	example
Remarques	La corrélation Pearson mesure la relation linéaire entre les deux variables. Les résultats vont de -1 à +1 inclus, où 1 dénote une relation linéaire positive exacte, 0 ne dénote aucune relation linéaire entre la variance, et -1 est une relation négative exacte. Le carré d’un résultat CORR est équivalent à la valeur R au carré pour un modèle de courbe de tendance linéaire. Consultez Termes relatifs aux modèles de courbe de tendance. Utiliser avec les expressions LOD limitée à une table : Vous pouvez utiliser CORR pour visualiser la corrélation dans une dispersion désagrégée à l’aide d’une expression de niveau de détail limitée à une table. Par exemple : {CORR(Sales, Profit)} Avec une expression de niveau de détail, la corrélation est exécutée sur toutes les lignes. Si vous avez utilisé une formule telle que `CORR(Sales, Profit)` (sans les parenthèses pour en faire une expression de niveau de détail), la vue devrait montrer la corrélation de chaque point individuel dans le nuage de points avec chaque autre point, qui n’est pas défini.
Limites de la base de données	La valeur `CORR` est disponible avec les sources de données suivantes : extraits de données Tableau, Cloudera Hive, EXASolution, Firebird (version 3.0 et ultérieure), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica. Pour les autres sources de données, vous pouvez envisager d’extraire les données ou d’utiliser `WINDOW_CORR`. Consultez Fonctions de calcul de table.

### COUNT

Syntaxe	`COUNT(expression)`
Définition	Renvoie le nombre d’éléments. Les valeurs nulles sont ignorées.

### COUNTD

Syntaxe	`COUNTD(expression)`
Définition	Renvoie le nombre d’éléments distincts d’un groupe. Les valeurs nulles sont ignorées.

### COVAR

Syntaxe	`COVAR(expression1, expression2)`
Définition	Renvoie la covariance d’échantillon de deux expressions.
Remarques	La covariance quantifie dans quelle mesure les deux variables changent ensemble. Une covariance positive indique que les variables tendent à évoluer dans la même direction, comme lorsque des valeurs plus importantes d’une variable tendent à correspondre à des valeurs plus importantes de l’autre variable, en moyenne. La covariance d’échantillon utilise le nombre de points de données non nulles n - 1 pour normaliser le calcul de la covariance, plutôt que n, qui est utilisé par la covariance de population (disponible avec la fonction `COVARP`). La covariance d’échantillon est le choix approprié lorsque les données sont un échantillon aléatoire utilisé pour estimer la covariance pour une population plus importante. Si l’`<expression1>` et l’`<expression2>` sont identiques, par exemple `COVAR([profit], [profit])`, `COVAR` renvoie une valeur qui indique dans quelles proportions les valeurs sont distribuées. La valeur de `COVAR(X, X)` est équivalente à la valeur de `VAR(X)` et également à la valeur de `STDEV(X)^2`.
Limites de la base de données	La valeur `COVAR` est disponible avec les sources de données suivantes : extraits de données Tableau, Cloudera Hive, EXASolution, Firebird (version 3.0 et ultérieure), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica. Pour les autres sources de données, vous pouvez envisager d’extraire les données ou d’utiliser `WINDOW_COVAR`. Consultez Fonctions de calcul de table.

### COVARP

Syntaxe	`COVARP(expression 1, expression2)`
Définition	Renvoie la covariance de population de deux expressions.
Remarques	La covariance quantifie dans quelle mesure les deux variables changent ensemble. Une covariance positive indique que les variables tendent à évoluer dans la même direction, comme lorsque des valeurs plus importantes d’une variable tendent à correspondre à des valeurs plus importantes de l’autre variable, en moyenne. La covariance de population est une covariance d’échantillon multipliée par (n-1)/n, où n est le nombre total de points de données non null. La covariance de population est le choix approprié dans les cas où des données sont disponibles pour tous les points d’intérêt par opposition aux cas où il n’existe qu’un sous-ensemble aléatoire d’éléments, dans quel cas la covariance d’échantillon (avec la fonction `COVAR`) est appropriée. Si l’`<expression1>` et l’`<expression2>` sont identiques, par exemple `COVARP([profit], [profit])`, `COVARP` renvoie une valeur qui indique dans quelles proportions les valeurs sont distribuées. Remarque : La valeur de `COVARP(X, X)` est équivalente à la valeur de `VARP(X)` et également à la valeur de `STDEVP(X)^2`.
Limites de la base de données	La valeur `COVARP` est disponible avec les sources de données suivantes : extraits de données Tableau, Cloudera Hive, EXASolution, Firebird (version 3.0 et ultérieure), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica Pour les autres sources de données, vous pouvez envisager d’extraire les données ou d’utiliser `WINDOW_COVAR`. Consultez Fonctions de calcul de table.

### MAX

Syntaxe	`MAX(expression)` ou `MAX(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données. `MAX` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MAX(4,7) = 7 MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# MAX([Name]) = "Zander"
Remarques	Pour les chaînes La valeur `MAX` vient généralement en dernier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MAX` est la plus élevée dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MAX` est la date la plus récente. Si `MAX` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MAX` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MIN`.

### MEDIAN

Syntaxe	`MEDIAN(expression)`
Définition	Renvoie la valeur médiane d’une expression dans tous les enregistrements. Les valeurs nulles sont ignorées.
Remarques	La valeur `MEDIAN` peut être utilisée uniquement avec des champs numériques.
Limites de la base de données	`MEDIAN` n’est pas disponible pour les sources de données suivantes : Access, Amazon Redshift, Cloudera Hadoop, HP Vertica, IBM DB2, IBM PDA (Netezza), Microsoft SQL Server, MySQL, SAP HANA, Teradata. Pour d’autres types de sources de données, vous pouvez extraire vos données dans un fichier d’extrait pour utiliser cette fonction. Consultez Extraire vos données.

### MIN

Syntaxe	`MIN(expression)` ou `MIN(expr1, expr2)`
Résultat	Même type de données que l’argument, ou `NULL` si une partie de l’argument est une valeur nulle.
Définition	Renvoie la valeur minimale des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ dans une agrégation.
Exemple	MIN(4,7) = 4 MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986# MIN([Name]) = "Abebi"
Remarques	Pour les chaînes La valeur `MIN` vient généralement en premier dans l’ordre alphabétique. Pour les sources de données de la base de données, la valeur de chaîne `MIN` est la plus basse dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, la valeur `MIN` est la date la plus proche. Si `MIN` est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si `MIN` est une comparaison, le résultat conservera la hiérarchie de dates. Comme agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que `AGG(expression)` dans la visualisation. Comme comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur de niveau ligne. Voir aussi `MAX`.

### PERCENTILE

Syntaxe	`PERCENTILE(expression, number)`
Définition	Renvoie la valeur du centile pour l’expression donnée correspondant au `<number>` indiqué. La valeur `<number>` doit être comprise entre 0 et 1 (inclus) et doit être une constante numérique.
Exemple	PERCENTILE([Score], 0.9)
Limites de la base de données	Cette fonction est disponible pour les sources de données suivantes : connexions Microsoft Excel et fichier texte récentes, extraits et les types de sources de données d’extraits uniquement (par exemple, Google Analytics, Protocole de données ouvertes ou Salesforce), Sybase IQ 15.1 et sources de données ultérieures, Oracle 10 et sources de données ultérieures, sources de données Cloudera Hive et Hortonworks Hadoop Hive, EXASolution 4.2 et sources de données ultérieures. Pour d’autres types de sources de données, vous pouvez extraire vos données dans un fichier d’extrait pour utiliser cette fonction. Consultez Extraire vos données.

### STDEV

Syntaxe	`STDEV(expression)`
Définition	Renvoie l’écart-type statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population.

### STDEVP

Syntaxe	`STDEVP(expression)`
Définition	Renvoie l’écart-type statistique de toutes les valeurs dans l’expression donnée en fonction d’une population biaisée.

### SUM

Syntaxe	`SUM(expression)`
Définition	Renvoie la somme de toutes les valeurs de l’expression. Les valeurs nulles sont ignorées.
Remarques	La valeur `SUM` peut être utilisée uniquement avec des champs numériques.

### VAR

Syntaxe	`VAR(expression)`
Définition	Renvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population.

### VARP

Syntaxe	`VARP(expression)`
Définition	Renvoie la variance statistique de toutes les valeurs dans l’expression donnée de la totalité de la population.

Fonctions utilisateur ### FULLNAME( )

Syntaxe	`FULLNAME( )`
Résultat	Chaîne
Définition	Renvoie le nom complet de l’utilisateur actuel.
Exemple	FULLNAME( ) Renvoie le nom complet de l’utilisateur connecté, par exemple, « Hamlin Myrer ». [Manager] = FULLNAME( ) Si le responsable « Hamlin Myrer » est connecté, cet exemple ne renvoie la valeur TRUE qu’en présence de la valeur « Hamlin Myrer » dans le champ Manager de la vue.
Remarques	Cette fonction recherche : Tableau Cloud et Tableau Server : le nom complet de l’utilisateur connecté Tableau Desktop : le nom complet local ou réseau de l’utilisateur Filtres utilisateur Lorsqu’il est utilisé comme filtre, un champ calculé `[Username field] = FULLNAME( )` peut être utilisé pour créer un filtre utilisateur qui n’affiche que les données correspondant à la personne connectée au serveur.

### ISFULLNAME

Syntaxe	`ISFULLNAME("User Full Name")`
Résultat	Booléen
Définition	Renvoie la valeur `TRUE` si le nom complet de l’utilisateur actuel correspond au nom complet spécifié; la valeur `FALSE` est renvoyée si ce n’est pas le cas.
Exemple	ISFULLNAME("Hamlin Myrer")
Remarques	L’argument `<"User Full Name">` doit être une chaîne littérale, et non un champ. Cette fonction recherche : Tableau Cloud et Tableau Server : le nom complet de l’utilisateur connecté Tableau Desktop : le nom complet local ou réseau de l’utilisateur

### ISMEMBEROF

Syntaxe	`ISMEMBEROF("Group Name")`
Résultat	Booléen ou valeur nulle
Définition	Renvoie `TRUE` si la personne qui utilise Tableau est membre d’un groupe qui correspond à la chaîne donnée, `FALSE` si elle n’est pas membre, et `NULL` si elle n’est pas connectée.
Exemple	ISMEMBEROF('Superstars') ISMEMBEROF('domain.lan\Sales')
Remarques	L’argument `<"Group Full Name">` doit être une chaîne littérale, et non un champ. Si l’utilisateur est connecté à Tableau Cloud ou Tableau Server, l’appartenance à un groupe est déterminée par les groupes Tableau. La fonction renverra TRUE si la chaîne donnée est « Tous les utilisateurs » La fonction `ISMEMBEROF( )` accepte également les domaines Active Directory. Le domaine Active Directory doit être déclaré dans le calcul avec le nom du groupe. Si l’appartenance d’un utilisateur à un groupe est modifiée, la modification des données basées sur l’appartenance au groupe est incluse dans un classeur ou une vue lors d’une nouvelle session. Les données obsolètes apparaîtront dans la session existante.

### ISUSERNAME

Syntaxe	`ISUSERNAME("username")`
Résultat	Booléen
Définition	Renvoie la valeur `TRUE` si le nom d’utilisateur de l’utilisateur actuel correspond au nom d’utilisateur spécifié ou la valeur `FALSE` est renvoyée si ce n’est pas le cas.
Exemple	ISUSERNAME("hmyrer")
Remarques	L’argument `<"username">` doit être une chaîne littérale, et non un champ. Cette fonction recherche : Tableau Cloud et Tableau Server : le nom d’utilisateur de l’utilisateur connecté Tableau Desktop : le nom d’utilisateur local ou réseau de l’utilisateur

### USERDOMAIN( )

Syntaxe	`USERDOMAIN( )`
Résultat	Chaîne
Définition	Renvoie le domaine de l’utilisateur actuel.
Remarques	Cette fonction recherche : Tableau Cloud et Tableau Server : le domaine utilisateur de l’utilisateur connecté Tableau Desktop : le domaine local si l’utilisateur se trouve sur un domaine

### USERNAME( )

Syntaxe	`USERNAME( )`
Résultat	Chaîne
Définition	Renvoie le nom d’utilisateur de l’utilisateur actuel.
Exemple	USERNAME( ) Renvoie le nom d’utilisateur de l’utilisateur connecté, par exemple, « hmyrer ». [Manager] = USERNAME( ) Si le responsable « hmyrer » est connecté, cet exemple ne renvoie la valeur TRUE qu’en présence de la valeur « hmyrer » dans le champ Manager de la vue « hmyrer ».
Remarques	Cette fonction recherche : Tableau Cloud et Tableau Server : le nom d’utilisateur de l’utilisateur connecté Tableau Desktop : le nom d’utilisateur local ou réseau de l’utilisateur Filtres utilisateur Lorsqu’il est utilisé comme filtre, un champ calculé `[Username field] = USERNAME( )` peut être utilisé pour créer un filtre utilisateur qui n’affiche que les données correspondant à la personne connectée au serveur.

### USERATTRIBUTE **Remarque** : Avant d’utiliser cette fonction, consultez [Fonctions d’attribut utilisateur pour contrôler et personnaliser l’accès aux données](https://help.tableau.com/current/pro/desktop/fr-ca/functions_functions_user.htm#user_attributes). Pour plus d’informations, selon votre flux de travail, consultez [Authentification et vues intégrées](https://help.tableau.com/current/api/embedding_api/fr-ca/docs/embedding_api_auth.html) dans l’aide de l’API d’intégration v3, les rubriques [OIDC](https://help.tableau.com/current/online/fr-ca/openid_auth_server_config.htm#user_attributes) ou [SAML](https://help.tableau.com/current/online/fr-ca/saml_config_site.htm#user_attributes) de Tableau Cloud, ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-ca/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-ca/config_saml.htm#user_attributes) de Tableau Server.

Syntaxe	`USERATTRIBUTE('attribute_name')`
Résultat	Chaîne ou valeur nulle
Définition	Si `<'attribute_name'>` fait partie du JWT (via des applications connectées, un UAT ou une revendication OIDC) ou de la réponse SAML XML transmis à Tableau, le calcul renvoie la première valeur de `<'attribute_name'>`. Renvoie une valeur nulle si `<'attribute_name'>` n’existe pas.
Exemple	Supposons que « Zone géographique » soit l’attribut utilisateur inclus dans la réponse JWT ou SAML et transmis à Tableau. En tant qu’auteur du classeur, vous pouvez configurer votre visualisation de manière à filtrer les données en fonction d’une zone géographique spécifique. Dans ce filtre, vous pouvez faire référence au calcul suivant. [Region] = USERATTRIBUTE("Region") Lorsque User2 de la zone géographique Ouest visualise la visualisation intégrée, Tableau affiche les données appropriées pour la zone géographique Ouest uniquement.
Remarques	Vous pouvez utiliser la fonction `USERATTRIBUTEINCLUDES` si vous vous attendez à ce que `<'attribute_name'>` renvoie plusieurs valeurs.

### USERATTRIBUTEINCLUDES **Remarque** : Avant d’utiliser cette fonction, consultez [Fonctions d’attribut utilisateur pour contrôler et personnaliser l’accès aux données](https://help.tableau.com/current/pro/desktop/fr-ca/functions_functions_user.htm#user_attributes). Pour plus d’informations, selon votre flux de travail, consultez [Authentification et vues intégrées](https://help.tableau.com/current/api/embedding_api/fr-ca/docs/embedding_api_auth.html) dans l’aide de l’API d’intégration v3, les rubriques [OIDC](https://help.tableau.com/current/online/fr-ca/openid_auth_server_config.htm#user_attributes) ou [SAML](https://help.tableau.com/current/online/fr-ca/saml_config_site.htm#user_attributes) de Tableau Cloud, ou les rubriques [OIDC](https://help.tableau.com/current/server/fr-ca/openid_auth_requirements.htm#user_attributes) ou [SAML](https://help.tableau.com/current/server/fr-ca/config_saml.htm#user_attributes) de Tableau Server.

Syntaxe	`USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`
Résultat	Booléen
Définition	Renvoie la valeur `TRUE` si les deux énoncés suivants sont vrais : `<'attribute_name'>` fait partie du JWT (via une application connectée, un UAT ou une revendication OIDC) ou de la réponse SAML XML transmis à Tableau un des valeurs de `<'attribute_name'>` correspond à la `<'expected_value'>`. Dans le cas contraire, renvoie la valeur `FALSE`.
Exemple	Supposons que « Zone géographique » soit l’attribut utilisateur inclus dans la réponse JWT ou SAML et transmis à Tableau. En tant qu’auteur du classeur, vous pouvez configurer votre visualisation de manière à filtrer les données en fonction d’une zone géographique spécifique. Dans ce filtre, vous pouvez faire référence au calcul suivant. USERATTRIBUTEINCLUDES('Region', [Region]) Si User2 de la zone géographique Ouest accède à la visualisation intégrée, Tableau vérifie si l’attribut utilisateur Zone géographique correspond à l’une des valeurs du champ [Zone géographique]. Lorsque la valeur est true, la visualisation affiche les données concernées. Lorsque User3, de la zone géographique Nord, accède à la même visualisation, il ne peut voir aucune donnée, car il n’y a pas de correspondance avec les valeurs du champ [Zone géographique].

Calculs de table ### FIRST( ) * * * Renvoie le nombre de lignes entre la ligne actuelle et la première ligne de la partition. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction FIRST() est calculée dans la partition des dates, le décalage de la première ligne par rapport à la seconde ligne est de -1. ![Calcul de table FIRST().](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_first.png) #### Exemple Lorsque l’index de la ligne actuelle est de 3, `FIRST() = -2`. ### INDEX( ) * * * Renvoie l’index de la ligne actuelle dans la partition, sans tri concernant la valeur. L’index de la première ligne commence à 1. Par exemple, la table ci-dessous présente les ventes trimestrielles. Lorsque la fonction INDEX() est calculée dans la partition des dates, l’index de chaque ligne est 1, 2, 3, 4, etc. ![Calcul de table INDEX().](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_index.png) #### Exemple Pour la troisième ligne de la partition, `INDEX() = 3`. ### LAST( ) * * * Renvoie le nombre de lignes entre la ligne actuelle et la dernière ligne de la partition. Par exemple, la table ci-dessous présente les ventes trimestrielles. Lorsque la fonction LAST() est calculée dans la partition des dates, le décalage de la dernière ligne par rapport à la seconde ligne est de 5. ![Calcul de table LAST().](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_last.png) #### Exemple Lorsque l’index de la ligne actuelle est de 3 sur 7, `LAST() = 4`. ### LOOKUP(expression, \[offset\]) * * * Renvoie la valeur de l’expression dans une ligne cible, indiquée sous la forme d’un décalage relatif par rapport à la ligne actuelle. Utilisez FIRST() + n et LAST() - n dans votre définition de décalage pour une cible relative aux première/dernière lignes de la partition. Si la valeur `offset` est ignorée, la ligne à comparer peut être définie dans le menu du champ. Cette fonction renvoie NULL si la ligne cible ne peut pas être déterminée. La vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction `LOOKUP (SUM(Sales), 2)`est calculée dans la partition des dates, chaque ligne affiche la valeur des ventes à partir de 2 trimestres dans le futur. ![Calcul de table LOOKUP.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_lookup.png) #### Exemple `LOOKUP(SUM([Profit]), FIRST()+2)` calcule la valeur SUM(\[Profit\]) dans la troisième ligne de la partition. ### Fonctions MODEL\_EXTENSION Les fonctions d'extension de modèle : - MODEL\_EXTENSION\_BOOL - MODEL\_EXTENSION\_INT - MODEL\_EXTENSION\_REAL - MODEL\_EXTENSION\_STRING sont utilisées pour transmettre des données à un modèle déployé sur un service externe comme R, TabPy ou Matlab. Consultez [Transmettre des expressions avec les extensions d’analytiques](https://help.tableau.com/current/pro/desktop/fr-ca/r_connection_manage.htm). ### MODEL\_PERCENTILE(target\_expression, predictor\_expression(s)) * * * Renvoie la probabilité (comprise entre 0 et 1) que la valeur attendue soit inférieure ou égale au repère observé, définie par l’expression cible et d’autres expressions de prédiction. Il s’agit de la fonction de distribution prédictive postérieure, également appelée fonction de distribution cumulative (CDF). Cette fonction est l’inverse de MODEL\_QUANTILE. Pour plus d’informations sur les fonctions de modélisation prédictive, consultez [Description des fonctions de modélisation prédictive dans Tableau](https://help.tableau.com/current/pro/desktop/fr-ca/predictions_overview.htm). #### Exemple La formule suivante renvoie le quantile du repère pour la somme des ventes, ajustée en fonction du nombre de commandes. `MODEL_PERCENTILE(SUM([Sales]), COUNT([Orders]))` ### MODEL\_QUANTILE(quantile, target\_expression, predictor\_expression(s)) * * * Renvoie une valeur numérique cible dans la plage probable définie par l’expression cible et d’autres expressions de prédiction, au quantile spécifié. Il s’agit du quantile prédictif postérieur. Cette fonction est l’inverse de MODEL\_PERCENTILE. Pour plus d’informations sur les fonctions de modélisation prédictive, consultez [Description des fonctions de modélisation prédictive dans Tableau](https://help.tableau.com/current/pro/desktop/fr-ca/predictions_overview.htm). #### Exemple La formule suivante renvoie la somme médiane (0.5) des ventes prévues, ajustée en fonction du nombre des commandes. `MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))` ### PREVIOUS\_VALUE(expression) * * * Renvoie la valeur de ce calcul dans la ligne précédente. Renvoie l’expression donnée si la ligne actuelle correspond à la première ligne de la partition. #### Exemple `SUM([Profit]) * PREVIOUS_VALUE(1)` calcule le produit cumulé de SUM(Profit). ### RANK(expression, \[’asc’ | ’desc’\]) * * * Renvoie le rang concurrentiel standard de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (4, 2, 2, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-ca/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). #### Exemple L’image suivante montre l’effet des différentes fonctions de classement (RANK, RANK\_DENSE, RANK\_MODIFIED, RANK\_PERCENTILE et RANK\_UNIQUE) sur un ensemble de valeurs. L’ensemble de données contient des informations sur 14 étudiants (de Étudiant A à Étudiant N). La colonne Âge affiche l’âge actuel de chaque étudiant (tous les étudiants ont entre 17 et 20 ans). Les colonnes restantes montrent l’effet de chaque fonction de classement sur l’ensemble des valeurs d’âge, en prenant toujours pour hypothèse l’ordre par défaut (croissant ou décroissant) pour la fonction. ![Un tableau comparant le rang des âges des étudiants en utilisant différentes méthodes de classement.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/rank_compare.png) ### RANK\_DENSE(expression, \[’asc’ | ’desc’\]) * * * Renvoie le rang dense de la ligne actuelle de la partition. Un classement identique est attribué aux valeurs identiques. La séquence de chiffres demeure toutefois linéaire. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (3, 2, 2, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-ca/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_MODIFIED(expression, \[’asc’ | ’desc’\]) * * * Renvoie le rang concurrentiel modifié de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (4, 3, 3, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-ca/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_PERCENTILE(expression, \[’asc’ | ’desc’\]) * * * Renvoie le rang centile de la ligne actuelle de la partition. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre croissant est défini par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (0,00, 0,67, 0,67, 1,00). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-ca/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RANK\_UNIQUE(expression, \[’asc’ | ’desc’\]) * * * Renvoie le rang unique de la ligne actuelle de la partition. Des classements différents sont attribués aux valeurs identiques. Utilisez l’argument facultatif `'asc' | 'desc'` pour utiliser l’ordre croissant ou décroissant. L’ordre décroissant est utilisé par défaut. Avec cette fonction, l’ensemble de valeurs (6, 9, 9, 14) serait organisé de la façon suivante (4, 2, 3, 1). Les valeurs nulles sont ignorées dans les fonctions de classement. Elles ne sont pas numérotées et ne sont pas prises en compte dans le nombre total d’enregistrements des calculs de rang centile. Pour plus d’informations sur les différentes options de classement, consultez [Calcul de classement](https://help.tableau.com/current/pro/desktop/fr-ca/calculations_tablecalculations_definebasic_runningtotal.htm#Rank). ### RUNNING\_AVG(expression) * * * Renvoie la moyenne cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle. La vue ci-dessous présente les ventes trimestrielles. Lorsque la fonction `RUNNING_AVG(SUM([Sales])` est calculée dans la partition des dates, le résultat obtenu correspond à une moyenne cumulée des valeurs de ventes pour chaque trimestre. ![Calcul de table avec une moyenne cumulée.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_runningavg.png) #### Exemple `RUNNING_AVG(SUM([Profit]))` calcule la moyenne cumulée de SUM(Profit). ### RUNNING\_COUNT(expression) * * * Renvoie le cumul d’une expression donnée, de la première ligne de la partition à la ligne actuelle. #### Exemple `RUNNING_COUNT(SUM([Profit]))` calcule le compte cumulée de SUM(Profit). ### RUNNING\_MAX(expression) * * * Renvoie le maximum cumulé d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec un maximum cumulé.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_runningmax.png) #### Exemple `RUNNING_MAX(SUM([Profit]))` calcule le cumul de SUM(Profit). ### RUNNING\_MIN(expression) * * * Renvoie le minimum cumulé d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec un minimum cumulé.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_runningmin.png) #### Exemple `RUNNING_MIN(SUM([Profit]))` calcule le minimum cumulé de SUM(Profit). ### RUNNING\_SUM(expression) * * * Renvoie la somme cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle. ![Calcul de table avec une somme cumulée.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_runningsum.png) #### Exemple `RUNNING_SUM(SUM([Profit]))` calcule la somme cumulée de SUM(Profit) ### SIZE() * * * Renvoie le nombre de lignes contenues dans la partition. Par exemple, la vue ci-dessous présente les ventes trimestrielles. La partition des dates contient sept lignes; la fonction Size() de la partition des dates est donc égale à 7. ![Calcul de table SIZE().](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_size.png) #### Exemple `SIZE() = 5` lorsque la partition actuelle contient cinq lignes. ### Fonctions SCRIPT\_ Les fonctions de script : - SCRIPT\_BOOL - SCRIPT\_INT - SCRIPT\_REAL - SCRIPT\_STRING sont utilisées pour transmettre des données à un service externe comme R, TabPy ou Matlab. Consultez [Transmettre des expressions avec les extensions d’analytiques](https://help.tableau.com/current/pro/desktop/fr-ca/r_connection_manage.htm). ### TOTAL(expression) * * * Renvoie le total de l’expression donnée dans la partition de calcul de table. #### Exemple Supposons que vous démarriez avec cette vue : ![Calcul de table Total.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total.png) Ouvrez l’éditeur de calculs et créez un nouveau champ. Nommez-le Totality : ![Calcul de table de la somme totale des ventes.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total2.png) Déposez ensuite Totality sur Texte, pour remplacer SUM(Sales). Votre vue change de sorte à totaliser les valeurs basées sur la valeur Calculer avec par défaut : ![Calcul de table ajouté à une visualisation.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total3.png) Ceci soulève la question : quelle est la valeur par défaut de Calculer avec? Si vous faites un clic droit (Contrôle + clic sur un Mac) sur Totality dans le volet Données et que vous choisissez Modifier, quelques informations supplémentaires sont disponibles : ![Calcul de table de la somme totale des ventes.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total4.png) La valeur par défaut pour Calculer avec est Table (horizontale). Le résultat est que Totality totalise les valeurs pour chaque ligne de votre table. Ainsi, la valeur que vous voyez pour chaque ligne est la somme de toutes les valeurs provenant de la version d’origine de la table. Les valeurs dans la ligne 2011/Q1 dans la table d’origine étaient $8601, $6579, $44262 et $15006. Les valeurs dans la table après que Totality a remplacé SUM(Sales) sont toutes $74,448, ce qui correspond à la somme des quatre valeurs d’origine. Notez le triangle en regard de Totality après que vous le déposez sur Texte : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total5.png) Il indique que le champ utilise un calcul de table. Vous pouvez faire un clic droit sur le champ et choisir Modifier le calcul de table pour rediriger votre fonction vers une valeur Calculer avec différente. Par exemple, vous pouvez la définir sur Table (horizontale). Dans ce cas, votre table se présenterait ainsi : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total6.png) ### TOTAL(expression) * * * Renvoie le total de l’expression donnée dans la partition de calcul de table. #### Exemple Supposons que vous démarriez avec cette vue : ![Calcul de table Total.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total.png) Ouvrez l’éditeur de calculs et créez un nouveau champ. Nommez-le Totality : ![Calcul de table de la somme totale des ventes.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total2.png) Déposez ensuite Totality sur Texte, pour remplacer SUM(Sales). Votre vue change de sorte à totaliser les valeurs basées sur la valeur Calculer avec par défaut : ![Calcul de table ajouté à une visualisation.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total3.png) Ceci soulève la question : quelle est la valeur par défaut de Calculer avec? Si vous faites un clic droit (Contrôle + clic sur un Mac) sur Totality dans le volet Données et que vous choisissez Modifier, quelques informations supplémentaires sont disponibles : ![Calcul de table de la somme totale des ventes.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total4.png) La valeur par défaut pour Calculer avec est Table (horizontale). Le résultat est que Totality totalise les valeurs pour chaque ligne de votre table. Ainsi, la valeur que vous voyez pour chaque ligne est la somme de toutes les valeurs provenant de la version d’origine de la table. Les valeurs dans la ligne 2011/Q1 dans la table d’origine étaient $8601, $6579, $44262 et $15006. Les valeurs dans la table après que Totality a remplacé SUM(Sales) sont toutes $74,448, ce qui correspond à la somme des quatre valeurs d’origine. Notez le triangle en regard de Totality après que vous le déposez sur Texte : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total5.png) Il indique que le champ utilise un calcul de table. Vous pouvez faire un clic droit sur le champ et choisir Modifier le calcul de table pour rediriger votre fonction vers une valeur Calculer avec différente. Par exemple, vous pouvez la définir sur Table (horizontale). Dans ce cas, votre table se présenterait ainsi : ![Calcul de table ajouté à une visualisation et affiché sur la fiche Repères.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_total6.png) ### WINDOW\_AVG(expression, \[début, fin\]) * * * Renvoie la moyenne de l’expression dans la fenêtre. La fenêtre est définie comme valeurs de décalage par rapport à la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Il existe une fonction d’agrégation équivalente : AVG. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la moyenne de la fenêtre de **SUM(Profit)** des deux précédentes lignes jusqu’à la ligne actuelle. `WINDOW_AVG(SUM[Profit]), -2, 0)` ### WINDOW\_CORR(expression1, expression2, \[start, end\]) * * * Renvoie le coefficient de corrélation Pearson de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. La corrélation Pearson mesure la relation linéaire entre les deux variables. Les résultats vont de -1 à +1 inclus, où 1 dénote une relation linéaire positive exacte, comme lorsqu’un changement positif dans une variable implique un changement positif de magnitude correspondante dans l’autre, 0 ne dénote aucune relation linéaire entre la variance, et -1 est une relation négative exacte. Il existe une fonction d’agrégation équivalente : CORR. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_alphabetical.htm). #### Exemple La formule suivante renvoie la corrélation Pearson de SUM(Profit) et SUM(Sales) depuis les cinq lignes précédentes jusqu’à la ligne actuelle. `WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)` ### WINDOW\_COUNT(expression, \[start, end\]) * * * Renvoie le total de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0)` calcule le cumul de SUM(Profit) de la deuxième ligne à la ligne actuelle ### WINDOW\_COVAR(expression1, expression2, \[start, end\]) * * * Renvoie la _covariance d’échantillon_ de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si les arguments de début et la fin sont ignorés, la fenêtre est la totalité de la partition. La covariance d’échantillon utilise le nombre de points de données non null n - 1 pour normaliser le calcul de la covariance, plutôt que n, qui est utilisé par la covariance de population (disponible avec la fonction WINDOW\_COVARP). La covariance d’échantillon est le choix approprié lorsque les données sont un échantillon aléatoire utilisé pour estimer la covariance pour une population plus importante. Il existe une fonction d’agrégation équivalente : COVAR. Consultez [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la covariance d’échantillon de SUM(Profit) et SUM(Sales) des deux précédentes lignes jusqu’à la ligne actuelle. `WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)` ### WINDOW\_COVARP(expression1, expression2, \[start, end\]) * * * Renvoie la _covariance de population_ de deux expressions dans la fenêtre. La fenêtre est définie comme valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. La covariance de population est une covariance d’échantillon multipliée par (n-1)/n, où n est le nombre total de points de données non null. La covariance de population est le choix approprié dans les cas où des données sont disponibles pour tous les points d’intérêt par opposition aux cas où il n’existe qu’un sous-ensemble aléatoire d’éléments, dans quel cas la covariance d’échantillon (avec la fonction WINDOW\_COVAR) est appropriée. Il existe une fonction d’agrégation équivalente : COVARP. [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_alphabetical.htm). #### Exemple La formule suivante retourne la covariance de population de SUM(Profit) et SUM(Sales) des deux précédentes lignes jusqu’à la ligne actuelle. `WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)` ### WINDOW\_MEDIAN(expression, \[start, end\]) * * * Renvoie le médian de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous représente les profits trimestriels. Un médian de la fenêtre dans la partition des dates renvoie les profits médians pour toutes les dates. ![Calcul de table avec un opérateur Médian de la fenêtre.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_windowmedian.png) #### Exemple `WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0)` calcule la médiane de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_MAX(expression, \[start, end\]) * * * Renvoie le maximum de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Un maximum de la fenêtre dans la partition des dates renvoie les ventes maximum pour toutes les dates. ![Calcul de table avec un opérateur Maximum de la fenêtre.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_windowmax.png) #### Exemple `WINDOW_MAX(SUM([Profit]), FIRST()+1, 0)` calcule le maximum de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_MIN(expression, \[start, end\]) * * * Renvoie le minimum de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Un minimum de la fenêtre dans la partition des dates renvoie les ventes minimum pour toutes les dates. ![Calcul de table avec un opérateur Minimum de la fenêtre.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_windowmin.png) #### Exemple `WINDOW_MIN(SUM([Profit]), FIRST()+1, 0)` calcule le minimum de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_PERCENTILE(expression, number, \[start, end\]) * * * Renvoie la valeur correspondant au centile spécifié dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0)` renvoie le 75e centile pour SUM(Profit), en partant des deux lignes précédant la ligne actuelle jusqu’à cette dernière. ### WINDOW\_STDEV(expression, \[start, end\]) * * * Renvoie l’échantillon d’écart-type de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0)` calcule l’écart-type SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_STDEVP(expression, \[start, end\]) * * * Renvoie l’écart-type biaisé de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0)` calcule l’écart-type SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_SUM(expression, \[start, end\]) * * * Renvoie la somme de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. Par exemple, la vue ci-dessous présente les ventes trimestrielles. Une somme de la fenêtre calculée dans la partition des dates renvoie la somme des ventes pour tous les trimestres. ![Calcul de table avec un opérateur Somme de la fenêtre.](/tableau/current/fr-ca/pro/desktop/fr-ca/Img/tablecalc_windowsum.png) #### Exemple `WINDOW_SUM(SUM([Profit]), FIRST()+1, 0)` calcule la somme de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_VAR(expression, \[start, end\]) * * * Renvoie l’échantillon de variance de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_VAR((SUM([Profit])), FIRST()+1, 0)` calcule la variance de SUM(Profit) de la deuxième ligne à la ligne actuelle. ### WINDOW\_VARP(expression, \[start, end\]) * * * Renvoie la variance biaisée de l’expression dans la fenêtre. La fenêtre est définie par les valeurs de décalage de la ligne actuelle. Utilisez FIRST()+n et LAST()-n pour les décalages à partir de la première ou la dernière ligne de la partition. Si le début et la fin sont ignorés, la totalité de la partition est utilisée. #### Exemple `WINDOW_VARP(SUM([Profit]), FIRST()+1, 0)` calcule la variance de SUM(Profit) de la deuxième ligne à la ligne actuelle. Fonctions de passage direct (RAWSQL) Ces fonctions de passage direct RAWSQL envoient des expressions SQL directement vers la base de données sans qu’elles ne soient interprétées par Tableau. Si vous possédez des fonctions de base de données personnalisées dont Tableau ne connaît pas l’existence, vous pouvez utiliser des fonctions de passage direct pour les exécuter. Vous devez définir cette agrégation lorsque nécessaire car Tableau n’interprète pas cette expression. Vous pouvez utiliser la version `RAWSQLAGG` d’une fonction lorsque vous avez besoin de transmettre une expression agrégée. Les fonctions de passage direct RAWSQL peuvent ne pas fonctionner avec des sources de données fédérées (combinées à partir de différentes bases de données) ou publiées. ## Syntaxe RAWSQL Les fonctions RAWSQL sont de deux types : désagrégées et agrégées. Ceci est spécifié dans la première partie du nom de la fonction, _RAWSQL_ ou _RAWSQLAGG_. La dernière partie du nom de la fonction est le type de sortie, tel que _BOOL,_ _STR_ ou _INT_. Dans toutes les fonctions RAWSQL, l’argument est `"sql_expr", [arg1], ...[arg2]`. Lors de l’écriture de la fonction, vous pouvez utiliser une syntaxe de substitution `%n` pour insérer le nom de champ ou l’expression approprié. ### Syntaxe de substitution %n Votre base de données ne comprend généralement pas les noms de champs affichés dans Tableau. Dans la mesure où Tableau n’interprète pas les expressions SQL des fonctions de passage direct, l’utilisation de noms de champs de Tableau dans votre expression peut entraîner des erreurs. Vous pouvez utiliser `%n` pour insérer l’expression ou le nom de champ approprié d’un calcul Tableau dans la requête SQL de passage direct. Par exemple, imaginez que vous disposez d’une fonction calculant la valeur médiane d’un ensemble de valeurs, vous pouvez l’appeler à partir de la colonne \[Sales\] de Tableau, comme suit : RAWSQLAGG\_REAL("MEDIAN(%1)", \[Sales\]) - `REALSQLAGG` pour spécifier l’agrégation. - `REAL`, car la sortie est numérique, mais pas nécessairement un entier. - `MEDIAN` représente l’agrégation en elle-même. - `%1` est l’espace réservé pour `[Ventes]`. ## Fonctions RAWSQL L’expression SQL est envoyée directement vers la base de données sous-jacente. Utilisez %n dans l’expression SQL comme syntaxe de substitution pour les valeurs de la base de données. Les fonctions RAWSQL suivantes sont disponibles dans Tableau : ### RAWSQL\_BOOL

Syntaxe	`RAWSQL_BOOL("sql_expr", [arg1], …[argN])`
Sortie	Booléen
Définition	Renvoie un résultat booléen à partir d’une expression SQL donnée.
Exemple	RAWSQL_BOOL("%1 > %2", [Sales], [Profit]) Dans cet exemple, %1 est égal à [Ventes] et %2 est égal à [Profit].

### RAWSQLAGG\_BOOL

Syntaxe	`RAWSQLAGG_BOOL("sql_expr", [arg1], …[argN])`
Sortie	Booléen
Définition	Renvoie un résultat booléen à partir d’une expression SQL d’agrégation.
Exemple	RAWSQLAGG_BOOL("SUM( %1) >SUM( %2)", [Sales], [Profit]) Dans cet exemple, %1 est égal à [Ventes] et %2 est égal à [Profit].

### RAWSQL\_DATE

Syntaxe	`RAWSQL_DATE("sql_expr", [arg1], …[argN])`
Sortie	Date
Définition	Renvoie un résultat de type Date à partir d’une expression SQL donnée.
Exemple	RAWSQL_DATE("%1", [Order Date]) Dans cet exemple, %1 est égal à [Date de commande].

### RAWSQLAGG\_DATE

Syntaxe	`RAWSQLAGG_DATE("sql_expr", [arg1], …[argN])`
Sortie	Date
Définition	Renvoie une date à partir d’une expression SQL d’agrégation
Exemple	RAWSQLAGG_DATE("MAX(%1)", [Order Date]) Dans cet exemple, %1 est égal à [Date de commande].

### RAWSQL\_DATETIME

Syntaxe	`RAWSQL_DATETIME("sql_expr", [arg1], …[argN])`
Sortie	Date et heure
Définition	Renvoie une valeur date et heure à partir d’une expression SQL donnée.
Exemple	RAWSQL_DATETIME("%1", [Order Date]) Dans cet exemple, %1 est égal à [Date de commande].

### RAWSQLAGG\_DATETIME

Syntaxe	`RAWSQLAGG_DATETIME("sql_expr", [arg1], …[argN])`
Sortie	Date et heure
Définition	Renvoie une valeur date et heure à partir d’une expression SQL d’agrégation.
Exemple	RAWSQLAGG_DATETIME("MIN(%1)", [Order Date]) Dans cet exemple, %1 est égal à [Date de commande].

### RAWSQL\_INT

Syntaxe	`RAWSQL_INT("sql_expr", [arg1], …[argN])`
Sortie	Entier
Définition	Renvoie un résultat entier à partir d’une expression SQL donnée.
Exemple	RAWSQL_INT("500 + %1", [Sales]) Dans cet exemple, %1 est égal à [Ventes].

### RAWSQLAGG\_INT

Syntaxe	`RAWSQLAGG_INT("sql_expr", [arg1,] …[argN])`
Sortie	Entier
Définition	Renvoie un résultat de nombre entier à partir d’une expression SQL d’agrégation.
Exemple	RAWSQLAGG_INT("500 + SUM(%1)", [Sales]) Dans cet exemple, %1 est égal à [Ventes].

### RAWSQL\_REAL

Syntaxe	`RAWSQL_REAL("sql_expr", [arg1], …[argN])`
Sortie	Numérique
Définition	Renvoie un résultat numérique à partir d’une expression SQL donnée.
Exemple	RAWSQL_REAL("-123.98 * %1", [Sales]) Dans cet exemple, %1 est égal à [Ventes].

### RAWSQLAGG\_REAL

Syntaxe	`RAWSQLAGG_REAL("sql_expr", [arg1,] …[argN])`
Sortie	Numérique
Définition	Renvoie un résultat numérique à partir d’une expression SQL d’agrégation.
Exemple	RAWSQLAGG_REAL("SUM( %1)", [Sales]) Dans cet exemple, %1 est égal à [Ventes].

### RAWSQL\_SPATIAL

Syntaxe	`RAWSQL_SPATIAL("sql_expr", [arg1], …[argN])`
Sortie	Données spatiales
Définition	Renvoie des données spatiales à partir d’une expression SQL donnée.
Exemple	RAWSQL_SPATIAL("%1", [Geometry]) Dans cet exemple, %1 est égal à [Geometry].
Remarque	Il n’y a pas de version `RAWSQLAGG` pour cette fonction.

### RAWSQL\_STR

Syntaxe	`RAWSQL_STR("sql_expr", [arg1], …[argN])`
Sortie	Chaîne
Définition	Renvoie une chaîne à partir d’une expression SQL donnée.
Exemple	RAWSQL_STR("%1", [Customer Name]) Dans cet exemple, %1 est égal à [Customer Name].

### RAWSQLAGG\_STR

Syntaxe	`RAWSQLAGG_STR("sql_expr", [arg1,] …[argN])`
Sortie	Chaîne
Définition	Renvoie une chaîne à partir d’une expression SQL d’agrégation.
Exemple	RAWSQLAGG_STR("AVG(%1)", [Discount]) Dans cet exemple, %1 est égal à [Discount].

Fonctions spatiales Les fonctions spatiales vous permettent d’effectuer une analyse spatiale avancée et de combiner des fichiers de données spatiales avec des données dans d’autres formats comme des fichiers texte ou des feuilles de calcul. ### AREA

Syntaxe	`AREA(Spatial Polygon, 'units')`
Résultat	Nombre
Définition	Renvoie la surface totale d’un `<spatial polygon>`.
Exemple	AREA([Geometry], 'feet')
Remarques	Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple `'miles'`) : mètres : mètres, m kilomètres : kilomètres, km milles : milles, mi pieds : pieds, pi

### BUFFER

Syntaxe	`BUFFER(Spatial point, distance, 'units')` `BUFFER(Spatial linestring, distance, 'units')` `BUFFER(Spatial polygon, distance, 'units')` mètres : mètres, m kilomètres : kilomètres, km milles : milles, mi pieds : pieds, pi
Résultat	Géométrie
Définition	Dans le cas des points spatiaux, renvoie une forme de polygone centrée sur un `<spatial point>`, avec un rayon déterminé par les valeurs `<distance>` et `<unit>`. Pour les chaînes de lignes, calcule les polygones formés en incluant tous les points situés dans le rayon de distance de la chaîne de lignes. Pour les polygones, calcule un polygone qui correspond soit à un encart (distance négative), soit à un début (distance positive) de chaque polygone donné.
Exemple	BUFFER([Spatial Point Geometry], 25, 'mi') BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km') BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))
Remarques	Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple `'miles'`) : mètres : mètres, m kilomètres : kilomètres, km milles : milles, mi pieds : pieds, pi

### DIFFÉRENCE

Syntaxe	`DIFFERENCE(Spatial, Spatial)`
Résultat	Polygone spatial
Définition	Calcule les parties des zones géographiques restantes lorsque toutes les zones géographiques du deuxième argument sont extraites du premier argument dans des zones qui se chevauchent. Rejette les zones géographiques du deuxième argument dans les zones qui ne se chevauchent pas.
Exemple	DIFFERENCE(Spatial Polygon1, Spatial Polygon2)
Remarques	Prend en charge les polygones et les multipolygones spatiaux, mais pas les lignes ni les points spatiaux.

### DISTANCE

Syntaxe	`DISTANCE(SpatialPoint1, SpatialPoint2, 'units')`
Résultat	Nombre
Définition	Renvoie la mesure de distance entre deux points dans une unité `<unit>` spécifiée.
Exemple	DISTANCE([Origin Point],[Destination Point], 'km')
Remarques	Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple `'miles'`) : mètres : mètres, m kilomètres : kilomètres, km milles : milles, mi pieds : pieds, pi
Limites de la base de données	Cette fonction ne peut être créée qu’avec une connexion en direct, mais elle continuera à fonctionner si une source de données est convertie en un extrait.

### INTERSECTION

Syntaxe	`INTERSECTION (spatial, spatial)`
Résultat	Polygones
Définition	Calcule et renvoie les parties des zones géographiques du deuxième argument qui chevauchent les zones géographiques du premier argument.
Exemple	`INTERSECTION (Polygone spatial1, Polygone spatial2)`
Remarques	Prend en charge les polygones et les multipolygones spatiaux, mais pas les lignes ni les points spatiaux.

### INTERSECTIONS

Syntaxe	`INTERSECTS (geometry1, geometry2)`
Résultat	Booléen
Définition	Renvoie une valeur true ou false indiquant si deux géométries se chevauchent dans l’espace.
Remarques	Combinaisons prises en charge : point/polygone, ligne/polygone et polygone/polygone.

### LENGTH

Syntaxe	`LENGTH(geometry, 'units')`
Résultat	Nombre
Définition	Renvoie la longueur du chemin géodésique de la ou des chaînes de ligne dans la `<geometry>` en utilisant les `<units>` données.
Exemple	LENGTH([Spatial], 'metres')
Remarques	Le résultat est `<NaN>` si l’argument géométrie n’a pas de chaîne de lignes, bien que d’autres éléments soient autorisés.

### MAKELINE

Syntaxe	`MAKELINE(SpatialPoint1, SpatialPoint2)`
Résultat	Géométrie (ligne)
Définition	Génère un repère de ligne entre deux points
Exemple	MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))
Remarques	Utile pour la création des cartes origine-destination.

### MAKEPOINT

Syntaxe	`MAKEPOINT(latitude, longitude, [SRID])`
Résultat	Géométrie (point)
Définition	Convertit les données des colonnes de `<latitude>` et de `<longitude>` en objets spatiaux. Si l’argument facultatif `<SRID>` est ajouté, il est possible de saisir d’autres coordonnées géographiques projetées.
Exemple	MAKEPOINT(48.5, -123.1) MAKEPOINT([AirportLatitude], [AirportLongitude]) MAKEPOINT([Xcoord],[Ycoord], 3493)
Remarques	`MAKEPOINT` ne peut pas utiliser les champs de latitude et de longitude générés automatiquement. La source de données doit contenir les coordonnées en natif. `SRID` est un identificateur de référence spatiale qui utilise les codes du système de référence ESPG pour spécifier les systèmes de coordonnées. Si `SRID` n’est pas spécifié, WGS84 est supposé et les paramètres sont traités comme latitude/longitude en degrés. Vous pouvez utiliser `MAKEPOINT` pour activer spatialement une source de données afin qu’elle puisse être liée à un fichier de données spatiales à l’aide d’une jointure de données spatiales. Pour plus d’information, consultez Lier des fichiers de données spatiales dans Tableau.

### NO\_CUTOUTS

Syntaxe	`NO_CUTOUTS (spatial)`
Résultat	Polygone spatial corrigé
Définition	Renvoie un polygone spatial corrigé si l’interprétation d’une terre plate nécessite des inversions de polygone. Dans le cas contraire, renvoie la valeur d’origine.
Remarques	Les formats de fichier de données spatiales comme Keyhole Markup Language (.kml) nécessitent que les limites de polygone suivent une direction de coordonnées spécifique. Si un ensemble de données trace des limites à l’envers, Tableau interprète l’espace extérieur comme la forme. `NO_CUTOUTS` réorganise ces coordonnées pour restaurer la disposition correcte.

### OUTLINE

Syntaxe	`OUTLINE(spatial polygon)`
Résultat	Géométrie
Définition	Convertit une géométrie de polygone en chaînes de lignes.
Remarques	Utile pour créer un calque séparé pour un contour avec un style différent de celui du remplissage. Prend en charge les polygones dans les multipolygones.

### PARSE\_WKT

Syntaxe	`PARSE_WKT (String)`
Résultat	Spatiale (Géographie)
Définition	Convertit un champ de chaîne de texte contenant des représentations au format WKT (Well Known Text) d’entités géographiques (comme des points, des chaînes de lignes ou des polygones) en une valeur spatiale.
Remarques	Les coordonnées sont supposées utiliser la latitude et la longitude WGS-84. Pour plus d’informations sur le format WKT, consultez Well-Known Text.

### SHAPETYPE

Syntaxe	`SHAPETYPE(geometry)`
Résultat	Chaîne
Définition	Renvoie une chaîne décrivant la structure de la `<geometry>` spatiale, par exemple Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed et des valeurs non prises en charge.
Exemple	SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

### SYMDIFFERENCE

Syntaxe	`SYMDIFFERENCE(spatial, spatial)`
Résultat	Géométrie
Définition	Calcule toutes les parties des zones géographiques du deuxième argument qui chevauchent les zones géographiques du premier argument et rejette des deux arguments. Renvoie les parties restantes des zones géographiques des deux arguments.
Exemple	`SYMDIFFERENCE(Spatial Polygon1, Spatial Polygon2)`

### UNION

Syntaxe	`UNION(spatial 1, [spatial 2])`
Résultat	Géométrie
Définition	Combine les géométries spatiales en fusionnant les limites adjacentes ou qui se chevauchent pour former une seule géométrie spatiale.
Remarques	Lorsqu’il est utilisé avec un argument (`UNION(spatial)`), `UNION` agit comme une fonction d’agrégation qui fusionne, sur l’ensemble des lignes, tous les objets spatiaux d’un champ. Lorsqu’il est utilisé avec deux arguments (`UNION(spatial1, spatial2)`), `UNION` fusionne deux champs spatiaux ou deux géométries distincts. Pour les points et les chaînes de lignes, `UNION` combine tous les éléments en une seule collection. Pour les polygones, les formes qui se chevauchent ou se touches sont fusionnées en un seul polygone ou multipolygone.

### VALIDATE

Syntaxe	`VALIDATE(spatial geometry)`
Résultat	Géométrie
Définition	Confirme l'exactitude topologique de la géométrie dans votre valeur spatiale. Si la valeur ne peut pas être utilisée pour l’analyse en raison de problèmes tels que l’intersection du périmètre d’un polygone avec lui-même, le résultat sera nul. Si la géométrie est correcte, le résultat sera la géométrie d'origine.
Exemple	`UNION(VALIDATE([Geometry]))`

Fonctions supplémentaires Voir également : [Fonctions de passage direct (RAWSQL).](https://help.tableau.com/current/pro/desktop/fr-ca/functions_functions_passthrough.htm) ## Expressions régulières Pour plus d’informations sur la syntaxe des expressions régulières, consultez la documentation de votre source de données. Dans les extraits Tableau, la syntaxe des expressions régulières est conforme aux standards de l’ICU (International Components for Unicode), un projet Open Source de bibliothèques C/C++ et Java pour la prise en charge d’Unicode et l’internationalisation/la globalisation des logiciels. Consultez la page [Expressions régulières](http://userguide.icu-project.org/strings/regexp) dans le guide de l’utilisateur en ligne d’ICU. ### REGEXP\_REPLACE

Syntaxe	`REGEXP_REPLACE(string, pattern, replacement)`
Sortie	Chaîne
Définition	Renvoie une copie de la chaîne donnée où le modèle d’expression régulière est remplacé par la chaîne de remplacement.
Exemple	REGEXP_REPLACE('abc 123', '\s', '-') = 'abc-123'
Remarques	Cette fonction est disponible pour les sources de données au format fichier texte, Hadoop Hive, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (version 14.1 et versions supérieures), Snowflake et Oracle. Pour les extraits de données Tableau, le modèle et le remplacement doivent être des constantes.

### REGEXP\_MATCH

Syntaxe	`REGEXP_MATCH(string, pattern)`
Sortie	Booléen
Définition	Renvoie "true" si une sous-chaîne de la chaîne spécifiée correspond au modèle d’expression régulière.
Exemple	REGEXP_MATCH('-([1234].[The.Market])-','\[\s(\w\.)(\w\s\])')=true
Remarques	Cette fonction est disponible pour les sources de données au format fichier texte, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (version 14.1 et versions supérieures), Impala 2.3.0 (via les sources de données Cloudera Hadoop), Snowflake et Oracle. Pour les extraits de données Tableau, le modèle doit être une constante.

### REGEXP\_EXTRACT

Syntaxe	`REGEXP_EXTRACT(string, pattern)`
Sortie	Chaîne
Définition	Renvoie la partie de la chaîne qui correspond au modèle d’expression régulière.
Exemple	REGEXP_EXTRACT('abc 123', '[a-z]+\s+(\d+)') = '123'
Remarques	Cette fonction est disponible pour les sources de données au format fichier texte, Hadoop Hive, Google BigQuery, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (version 14.1 et versions supérieures), Snowflake et Oracle. Pour les extraits de données Tableau, le modèle doit être une constante.

### REGEXP\_EXTRACT\_NTH

Syntaxe	`REGEXP_EXTRACT_NTH(string, pattern, index)`
Sortie	Chaîne
Définition	Renvoie la partie de la chaîne qui correspond au modèle d’expression régulière. La sous-chaîne est associée au nth groupe de capture, où n est l’index donné. Si l’index est 0, la chaîne complète est retournée.
Exemple	REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\s+(\d+)', 2) = '123'
Remarques	Cette fonction est disponible pour les sources de données au format fichier texte, PostgreSQL, Tableau Data Extract, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (version 14.1 et versions supérieures) et Oracle. Pour les extraits de données Tableau, le modèle doit être une constante.

## Fonctions spécifiques Hadoop Hive **Remarque :** seules les fonctions PARSE\_URL et PARSE\_URL\_QUERY sont disponibles pour les sources de données Cloudera Impala. ### GET\_JSON\_OBJECT(JSON string, JSON path) Renvoie l’objet JSON au sein de la chaîne JSON basée sur le chemin JSON. ### PARSE\_URL(string, url\_part) Renvoie un composant de la chaîne URL donnée où le composant est défini par url\_part. Les valeurs url\_part valides comprennent : ’HOST’, ’PATH’, ’QUERY’, ’REF’, ’PROTOCOL’, ’AUTHORITY’, ’FILE’ et ’USERINFO’. Exemple `PARSE_URL('http://www.tableau.com', 'HOST') = 'www.tableau.com'` ### PARSE\_URL\_QUERY(string, key) Renvoie la valeur du paramètre de requête spécifiée dans la chaîne URL donnée. Le paramètre de requête est défini par la clé. Exemple `PARSE_URL_QUERY('http://www.tableau.com?page=1&cat=4', 'page') = '1'` ### XPATH\_BOOLEAN(XML string, XPath expression string) Renvoie vrai si l’expression XPath correspond à un nœud ou évalue sur vrai. Exemple `XPATH_BOOLEAN(' 15', 'values/value[@id="1"] = 5') = true` ### XPATH\_DOUBLE(XML string, XPath expression string) Renvoie la valeur en virgule flottante de l’expression XPath. Exemple `XPATH_DOUBLE('1.05.5 ', 'sum(value/*)') = 6.5` ### XPATH\_FLOAT(XML string, XPath expression string) Renvoie la valeur en virgule flottante de l’expression XPath. Exemple `XPATH_FLOAT('1.05.5 ','sum(value/*)') = 6.5` ### XPATH\_INT(XML string, XPath expression string) Renvoie la valeur numérique de l’expression XPath ou zéro si l’expression XPath ne peut pas évaluer vers un chiffre. Exemple `XPATH_INT('15 ','sum(value/*)') = 6` ### XPATH\_LONG(XML string, XPath expression string) Renvoie la valeur numérique de l’expression XPath ou zéro si l’expression XPath ne peut pas évaluer vers un chiffre. Exemple `XPATH_LONG('15 ','sum(value/*)') = 6` ### XPATH\_SHORT(XML string, XPath expression string) Renvoie la valeur numérique de l’expression XPath ou zéro si l’expression XPath ne peut pas évaluer vers un chiffre. Exemple `XPATH_SHORT('15 ','sum(value/*)') = 6` ### XPATH\_STRING(XML string, XPath expression string) Renvoie le texte du premier nœud correspond. Exemple `XPATH_STRING('http://www.w3.org http://www.tableau.com', 'sites/url[@domain="com"]') = 'http://www.tableau.com'` ## Fonctions spécifiques Google BigQuery ### DOMAIN(string\_url) Avec une chaîne URL, renvoie le domaine en tant que chaîne. Exemple `DOMAIN('http://www.google.com:80/index.html') = 'google.com'` ### GROUP\_CONCAT(expression) Lie les valeurs de chaque entrée dans une chaîne unique délimitée par des virgules. Cette fonction agit comme une SUM() pour les chaînes. Exemple `GROUP_CONCAT(Region) = "Central,East,West"` ### HOST(string\_url) Avec une chaîne URL, renvoie le nom d’hôte en tant que chaîne. Exemple `HOST('http://www.google.com:80/index.html') = 'www.google.com:80'` ### LOG2(number) Renvoie le logarithme base 2 d’un chiffre. Exemple `LOG2(16) = '4.00'` ### LTRIM\_THIS(string, string) Renvoie la première chaîne avec toute occurrence de fin de la deuxième chaîne supprimée. Exemple `LTRIM_THIS('[-Sales-]','[-') = 'Sales-]'` ### RTRIM\_THIS(string, string) Renvoie la première chaîne avec toute occurence de fin de la deuxième chaîne supprimée. Exemple `RTRIM_THIS('[-Market-]','-]') = '[-Market'` ### TIMESTAMP\_TO\_USEC(expression) Convertit un type de données TIMESTAMP en un horodatage UNIX en microsecondes. Exemple `TIMESTAMP_TO_USEC(#2012-10-01 01:02:03#)=1349053323000000` ### USEC\_TO\_TIMESTAMP(expression) Convertit un horodatage UNIX en microsecondes en un type de données TIMESTAMP. Exemple `USEC_TO_TIMESTAMP(1349053323000000) = #2012-10-01 01:02:03#` ### TLD(string\_url) Avec une chaîne URL, renvoie le domaine de niveau supérieur et tout domaine de pays dans l’URL. Exemple `TLD('http://www.google.com:80/index.html') = '.com'` `TLD('http://www.google.co.uk:80/index.html') = '.co.uk'` ## Vous souhaitez en savoir plus sur les fonctions? Lisez les [rubriques consacrées aux fonctions](https://help.tableau.com/current/pro/desktop/fr-ca/functions.htm). ## Voir également [Fonctions de Tableau (par ordre alphabétique)](https://help.tableau.com/current/pro/desktop/fr-ca/functions_all_alphabetical.htm)