Fonctions de Tableau (par ordre alphabétique)

Dans cette référence, les fonctions de Tableau sont organisées par ordre alphabétique. Cliquez sur une lettre pour accéder à cet emplacement dans la liste. Vous pouvez également utiliser Ctrl+F (Cmd-F sur un Mac) pour ouvrir un champ de recherche pour rechercher une fonction spécifique.

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z


A

ABS

SyntaxeABS(number)
RésultatNombre (positif)
DéfinitionRenvoie 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.

RemarquesVoir aussi SIGN.

ACOS

SyntaxeACOS(number)
RésultatNombre (angle en radians)
DéfinitionRenvoie l’arc cosinus (angle) d’un <number> donné.
Exemple
ACOS(-1) = 3.14159265358979
RemarquesLa fonction inverse, COS, utilise l’angle exprimé en radians comme argument et renvoie le cosinus.

AND

Syntaxe<expr1> AND <expr2>
DéfinitionConjonction logique entre deux expressions. (Si les deux expressions sont définies sur vrai, le test logique renvoie un résultat positif.)
RésultatBooléen
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.

AREA

SyntaxeAREA(Spatial Polygon, 'units')
RésultatNombre
DéfinitionRenvoie 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

ASCII

SyntaxeASCII(string)
RésultatNombre
DéfinitionRenvoie le code ASCII du premier caractère d’une <string>.
Exemple
ASCII('A') = 65
RemarquesIl s’agit de l’inverse de la fonction CHAR.

ASIN

SyntaxeASIN(number)
RésultatNombre (angle en radians)
DéfinitionRenvoie l’arc sinus (angle) d’un <number> donné.
Exemple
ASIN(1) = 1.5707963267949
RemarquesLa fonction inverse, SIN, utilise l’angle exprimé en radians comme argument et renvoie le sinus.

ATAN

SyntaxeATAN(number)
RésultatNombre (angle en radians)
DéfinitionRenvoie 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

SyntaxeATAN2(y number, x number)
RésultatNombre (angle en radians)
DéfinitionRenvoie l’arc tangente (angle) entre deux nombres (<y number> et <x number>). Le résultat est exprimé en radians.
Exemple
ATAN2(2, 1) = 1.10714871779409
RemarquesVoir aussi ATAN, TAN et COT.

ATTR

SyntaxeATTR(expression)
DéfinitionRenvoie 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

SyntaxeAVG(expression)
DéfinitionRenvoie la moyenne de toutes les valeurs de l’<expression>. Les valeurs nulles sont ignorées.
RemarquesLa valeur AVG peut être utilisée uniquement avec des champs numériques.

retour en haut

B

BUFFER

SyntaxeBUFFER(Spatial Point, distance, 'units')
RésultatGéométrie
DéfinitionRenvoie une forme de polygone centrée sur un <spatial point>, avec un rayon déterminé par les valeurs <distance> et <unit>.
Exemple
BUFFER([Spatial Point Geometry], 25, 'mi')
BUFFER(MAKEPOINT(47.59, -122.32), 3, '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

retour en haut

C

CASE

SyntaxeCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
RésultatDé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 (facultative) 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.

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.

CEILING

SyntaxeCEILING(number)
RésultatEntier
DéfinitionArrondit un <number> à l’entier le plus proche ou à la valeur la plus importante.
Exemple
CEILING(2.1) = 3
RemarquesVoir 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.

CHAR

SyntaxeCHAR(number)
RésultatChaîne
DéfinitionRenvoie le caractère encodé à l’aide du nombre du code ASCII <number>.
Exemple
CHAR(65) = 'A'
RemarquesIl s’agit de l’inverse de la fonction ASCII.

COLLECT

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

CONTAINS

SyntaxeCONTAINS(string, substring)
RésultatBooléen
DéfinitionRenvoie true si la <string> contient la <substring> indiquée.
Exemple
CONTAINS("Calculation", "alcu") = true
RemarquesVoir aussi la fonction logique(Le lien s’ouvre dans une nouvelle fenêtre) IN ainsi que la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

CORR

SyntaxeCORR(expression1, expression2)
RésultatNombre de -1 à 1
DéfinitionRenvoie 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(Le lien s’ouvre dans une nouvelle fenêtre).

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(Le lien s’ouvre dans une nouvelle fenêtre). 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(Le lien s’ouvre dans une nouvelle fenêtre).

COS

SyntaxeCOS(number)

L’argument numérique est l’angle exprimé en radians.

RésultatNombre
DéfinitionRenvoie 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.

COT

SyntaxeCOT(number)

L’argument numérique est l’angle exprimé en radians.

RésultatNombre
DéfinitionRenvoie la cotangente d’un angle.
Exemple
COT(PI( ) /4) = 1
RemarquesVoir aussi ATAN, TAN et PI.

COUNT

SyntaxeCOUNT(expression)
DéfinitionRenvoie le nombre d’éléments. Les valeurs nulles sont ignorées.

COUNTD

SyntaxeCOUNTD(expression)
DéfinitionRenvoie le nombre d’éléments distincts d’un groupe. Les valeurs nulles sont ignorées.

COVAR

SyntaxeCOVAR(expression1, expression2)
DéfinitionRenvoie 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(Le lien s’ouvre dans une nouvelle fenêtre).

COVARP

SyntaxeCOVARP(expression 1, expression2)
DéfinitionRenvoie 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 nulles. 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(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

D

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.

SyntaxeDATE(expression)
RésultatDate
DéfinitionRenvoie 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.

SyntaxeDATEADD(date_part, interval, date)
RésultatDate
DéfinitionRetourne la date indiquée en ajoutant l’<interval> du nombre spécifié à <date_part spécifiée 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#
RemarquesPrend en charge les dates ISO 8601.

DATEDIFF

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

SyntaxeDATEDIFF(date_part, date1, date2, [start_of_week])
RésultatEntier
DéfinitionRenvoie 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])
RemarquesPrend 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.

SyntaxeDATENAME(date_part, date, [start_of_week])
RésultatChaîne
DéfinitionRenvoie <date_part> 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.

SyntaxeDATEPARSE(date_format, date_string)
RésultatDate
DéfinitionL’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, consultez Convertir un champ en un champ de date(Le lien s’ouvre dans une nouvelle fenêtre).
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.

SyntaxeDATEPART(date_part, date, [start_of_week])
RésultatEntier
DéfinitionRenvoie la <date_part> d’une date sous la forme d’un 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.

DATETIME

SyntaxeDATETIME(expression)
RésultatDatetime
DéfinitionRenvoie une date et une heure en fonction d’un nombre, d’une chaîne ou d’une expression de date.
Exemple
DATETIME("April 15, 2005 07:59:00") = April 15, 2005 07:59:00

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.

SyntaxeDATETRUNC(date_part, date, [start_of_week])
RésultatDate
DéfinitionTronque 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(Le lien s’ouvre dans une nouvelle fenêtre).

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.

DAY

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

SyntaxeDAY(date)
RésultatEntier
DéfinitionRenvoie le jour d’une <date> donnée sous la forme d’un entier.
Exemple
Day(#September 22, 2018#) = 22
RemarquesVoir aussi WEEK, MONTH, Trimestre, YEAR et les équivalents ISO

DEGREES

SyntaxeDEGREES(number)

L’argument numérique est l’angle exprimé en radians.

RésultatNombre (degrés)
DéfinitionConvertit 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().

DISTANCE

SyntaxeDISTANCE(<SpatialPoint1>, <SpatialPoint2>, 'units')
RésultatNombre
DéfinitionRenvoie la mesure de distance entre deux points dans une unité units 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) :

  • mètres : mètres, m
  • kilomètres : kilomètres, km
  • milles : milles, mi
  • pieds : pieds, pi
Limites de la base de donnéesCette 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.

DIV

SyntaxeDIV(integer1, integer2)
RésultatEntier
DéfinitionRetourne la part d’entier d’une opération de division, à savoir <integer1> divisé par <integer2>.
Exemple
DIV(11,2) = 5

DOMAIN

DOMAIN(string_url)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

E

ELSE

SyntaxeCASE <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éfinitionUtilisé 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

ENDSWITH

ENDSWITH

SyntaxeENDSWITH(string, substring)
RésultatBooléen
DéfinitionRenvoie true si la <string> donnée se termine par la <substring> indiquée. Les espaces en fin de chaîne sont ignorés.
Exemple
ENDSWITH("Tableau", "leau") = true
RemarquesVoir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

EXCLUDE

Pour plus d’information, consultez Expressions de niveau de détail(Le lien s’ouvre dans une nouvelle fenêtre).

EXP

SyntaxeEXP(number)
RésultatNombre
DéfinitionRenvoie la valeur e élevée à la puissance du <number> donné.
Exemple
EXP(2) = 7.389
EXP(-[Growth Rate]*[Time])
RemarquesVoir aussi LN.

retour en haut

F

FIND

SyntaxeFIND(string, substring, [start])
RésultatNombre
Définition

Renvoie la position d’index de la <substring> dans la <string>, 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
RemarquesVoir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

FINDNTH

SyntaxeFINDNTH(string, substring, occurrence)
RésultatNombre
DéfinitionRenvoie la position de la nième occurrence de la <substring> dans la <string> spécifiée, où n est défini par l’argument d’<occurence>.
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(Le lien s’ouvre dans une nouvelle fenêtre).

FIRST

FIRST()

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

FIXED

Pour plus d’information, consultez Expressions de niveau de détail(Le lien s’ouvre dans une nouvelle fenêtre).

FLOAT

SyntaxeFLOAT(expression)
RésultatNombre en virgule flottante (décimal)
DéfinitionConvertit l’argument en nombre à virgule flottante.
Exemple
FLOAT(3) = 3.000
RemarquesVoir également INT qui renvoie un entier.

FLOOR

SyntaxeFLOOR(number)
RésultatEntier
DéfinitionArrondit un <number> à l’entier le plus proche de valeur inférieure ou égale.
Exemple
FLOOR(7.9) = 7
RemarquesVoir 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.

FULLNAME

SyntaxeFULLNAME( )
RésultatChaî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.

retour en haut

G

GET_JSON_OBJECT

GET_JSON_OBJECT(JSON string, JSON path)

Pris en charge uniquement lorsque connecté à Hadoop Hive. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

GROUP_CONCAT

GROUP_CONCAT(expression)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

H

HEXBINX

SyntaxeHEXBINX(number, number)
RésultatNombre
DéfinitionMappe 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)
RemarquesHEXBINX 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

SyntaxeHEXBINY(number, number)
RésultatNombre
DéfinitionMappe 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)
RemarquesVoir aussi HEXBINX.

HOST

HOST(string_url)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

I

IF

SyntaxeIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
RésultatDé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

SyntaxeIFNULL(expr1, expr2)
RésultatDé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

SyntaxeIIF(<test>, <then>, <else>, [<unknown>])
RésultatDépend du type de données des valeurs de l’expression.
DéfinitionVé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ésultatBooléen(vrai ou faux)
DéfinitionRenvoie 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.

INCLUDE

Pour plus d’information, consultez Expressions de niveau de détail(Le lien s’ouvre dans une nouvelle fenêtre).

INDEX

INDEX( )

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

INT

SyntaxeINT(expression)
RésultatEntier
DéfinitionConvertit l’argument en nombre entier. Dans le cas des expressions, cette fonction tronque le résultat au nombre entier le plus proche de zéro.
Exemple
INT(8/3) = 2
INT(-9.7) = -9
Remarques

Lorsqu’une chaîne est convertie en nombre entier, celui-ci est d’abord converti en nombre à virgule flottante avant d’être arrondi.

Voir également FLOAT qui renvoie une décimale.
Voir également ROUND, CEILING et FLOOR

INTERSECTIONS

SyntaxeINTERSECTS (<geometry1>, <geometry2>)
RésultatBooléen
DéfinitionRenvoie une valeur true ou false indiquant si deux géométries se chevauchent dans l’espace.
RemarquesCombinaisons prises en charge : point/polygone, ligne/polygone et polygone/polygone.

ISDATE

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

SyntaxeISDATE(string)
RésultatBooléen
DéfinitionRenvoie la valeur true si une <string> donnée est une date valide.
Exemple
ISDATE(09/22/2018) = true
ISDATE(22SEP18) = false
RemarquesL’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.

ISFULLNAME

SyntaxeISFULLNAME("User Full Name")
RésultatBoolé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

SyntaxeISMEMBEROF("Group Name")
RésultatBoolé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.

ISNULL

SyntaxeISNULL(expression)
RésultatBoolé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.

ISOQUARTER

SyntaxeISOQUARTER(date)
RésultatEntier
DéfinitionRenvoie le trimestre ISO8601 basé sur les semaines d’une <date> donnée sous la forme d’un entier.
Exemple
ISOQUARTER(#1986-03-25#) = 1
RemarquesConsultez aussi ISOWEEK, ISOWEEKDAY, ISOYEAR et leurs équivalents non ISO.

ISOWEEK

SyntaxeISOWEEK(date)
RésultatEntier
DéfinitionRenvoie 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
RemarquesConsultez aussi ISOWEEKDAY, ISOQUARTER, ISOYEAR et leurs équivalents non ISO.

ISOWEEKDAY

SyntaxeISOWEEKDAY(date)
RésultatEntier
DéfinitionRenvoie 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
RemarquesConsultez aussi ISOWEEK, ISOQUARTER, ISOYEAR et leurs équivalents non ISO

ISOYEAR

SyntaxeISOYEAR(date)
RésultatEntier
DéfinitionRenvoie l’année ISO8601 basée sur les semaines d’une date donnée sous la forme d’un nombre entier.
Exemple
ISOYEAR(#1986-03-25#) = 1,986
RemarquesConsultez aussi ISOWEEK, ISOWEEKDAY, ISOQUARTER et leurs équivalents non ISO.

ISUSERNAME

SyntaxeISUSERNAME("username")
RésultatBooléen
DéfinitionRenvoie la valeur TRUE si le nom d’utilisateur de l’utilisateur actuel correspond au <username> 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

retour en haut

J

retour en haut

K

retour en haut

L

LAST

LAST()

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

LEFT

Syntaxe LEFT(string, number)
RésultatChaîne
DéfinitionRenvoie les caractères <number> situés le plus à gauche dans la chaîne.
Exemple
LEFT("Matador", 4) = "Mata"
RemarquesVoir également MID et RIGHT.

LEN

SyntaxeLEN(string)
RésultatNombre
DéfinitionRenvoie la longueur de la <string>.
Exemple
LEN("Matador") = 7
RemarquesÀ ne pas confondre avec la fonction spatiale LENGTH.

LENGTH

SyntaxeLENGTH(geometry, 'units')
RésultatNombre
DéfinitionRenvoie 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.

À ne pas confondre avec la fonction de chaîne LEN.

LN

SyntaxeLN(number)
Résultat

Nombre

La sortie est Null si l’argument est inférieur ou égal à zéro.

DéfinitionRenvoie le logarithme naturel d’un <number>.
Exemple
LN(50) = 3.912023005
RemarquesVoir aussi EXP et LOG.

LOG

SyntaxeLOG(number, [base])

S’il n’y a aucun argument de base facultatif, la base 10 est utilisée.

RésultatNombre
DéfinitionRenvoie le logarithme naturel d’un <number> pour la <base> donnée.
Exemple
LOG(16,4) = 2
RemarquesVoir aussi POWER LN.

LOG2

LOG2(number)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

LOOKUP

LOOKUP(expression, [offest])

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

LOWER

SyntaxeLOWER(string)
RésultatChaîne
DéfinitionRenvoie la <string> fournie en caractères tout en minuscules.
Exemple
LOWER("ProductVersion") = "productversion"
RemarquesVoir également UPPER et PROPER.

LTRIM

Syntaxe LTRIM(string)
RésultatChaîne
DéfinitionRenvoie la <string> fournie en supprimant les espaces de début.
Exemple
LTRIM(" Matador ") = "Matador "
RemarquesVoir également RTRIM.

LTRIM_THIS

LTRIM_THIS(string, string)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

M

MAKEDATE

SyntaxeMAKEDATE(year, month, day)
RésultatDate
DéfinitionRenvoie une valeur de date créée à partir de l’<year>, du <monthg> 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

SyntaxeMAKEDATETIME(date, time)
RésultatDatetime
DéfinitionRenvoie 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.

MAKELINE

SyntaxeMAKELINE(SpatialPoint1, SpatialPoint2)
RésultatGéométrie (ligne)
DéfinitionGénère un repère de ligne entre deux points
Exemple
MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))
RemarquesUtile pour la création des cartes origine-destination.

MAKEPOINT

SyntaxeMAKEPOINT(latitude, longitude, [SRID])
RésultatGé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.

Le SRID est un identificateur de référence spatiale qui utilise les codes du système de référence ESPG(Le lien s’ouvre dans une nouvelle fenêtre) 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 Joindre des fichiers de données spatiales dans Tableau(Le lien s’ouvre dans une nouvelle fenêtre).

MAKETIME

SyntaxeMAKETIME(hour, minute, second)
RésultatDatetime
DéfinitionRenvoie 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

SyntaxeMAX(expression) ou MAX(expr1, expr2)
RésultatMê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

SyntaxeMEDIAN(expression)
DéfinitionRenvoie la valeur médiane d’une expression dans tous les enregistrements. Les valeurs nulles sont ignorées.
RemarquesLa 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(Le lien s’ouvre dans une nouvelle fenêtre).

MID

Syntaxe(MID(string, start, [length])
RésultatChaî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"
RemarquesVoir aussi la fonction RegEx prise en charge dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

MIN

SyntaxeMIN(expression) ou MIN(expr1, expr2)
RésultatMê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.

Extensions de modèle

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

  • MODEL_EXTENSION_BOOL
  • MODEL_EXTENSION_INT
  • MODEL_EXTENSION_REAL
  • MODEL_EXTENSION_STR

MODEL_PERCENTILE

SyntaxeMODEL_PERCENTILE(
model_specification (optional),
target_expression,
predictor_expression(s))
DéfinitionRenvoie 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 prédicteurs. Il s’agit de la fonction de distribution prédictive postérieure, également appelée fonction de distribution cumulative (CDF).
Exemple
MODEL_PERCENTILE( SUM([Sales]),COUNT([Orders]))

MODEL_QUANTILE

SyntaxeMODEL_QUANTILE(
model_specification (optional),
quantile,
target_expression,
predictor_expression(s))
DéfinitionRenvoie 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.
Exemple
MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))

MONTH

SyntaxeMONTH(date)
RésultatEntier
DéfinitionRenvoie le mois d’une <date> donnée sous la forme d’un entier.
Exemple
MONTH(#1986-03-25#) = 3
RemarquesVoir aussi DAY, WEEK, Trimestre, YEAR et les équivalents ISO

retour en haut

N

NOT

SyntaxeNOT <expression>
RésultatBooléen(vrai ou faux)
DéfinitionNé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é, Ne portez pas de sandales est renvoyé. Dans le cas contraire, Portez des sandales est renvoyé. »

Remarques

Souvent utilisé avec IF et IIF. Voir également Dans cette référence, les fonctions de Tableau sont organisées par ordre alphabétique. Cliquez sur une lettre pour accéder à cet emplacement dans la liste. Vous pouvez également utiliser Ctrl+F (Cmd-F sur un Mac) pour ouvrir un champ de recherche pour rechercher une fonction spécifique. et OU.

NOW

SyntaxeNOW()
RésultatDatetime
DéfinitionRenvoie 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.

retour en haut

O

OU

Syntaxe<expr1> OR <expr2>
RésultatBooléen(vrai ou faux)
DéfinitionDisjonction 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 Dans cette référence, les fonctions de Tableau sont organisées par ordre alphabétique. Cliquez sur une lettre pour accéder à cet emplacement dans la liste. Vous pouvez également utiliser Ctrl+F (Cmd-F sur un Mac) pour ouvrir un champ de recherche pour rechercher une fonction spécifique. 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.

OUTLINE

SyntaxeOUTLINE(<spatial polygon>)
RésultatGéométrie
DéfinitionConvertit 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.

retour en haut

P

PARSE_URL

PARSE_URL(string, url_part)

Pris en charge uniquement lorsque connecté à Cloudera Impala. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

PARSE_URL_QUERY

PARSE_URL_QUERY(string, key)

Pris en charge uniquement lorsque connecté à Cloudera Impala. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

PERCENTILE

SyntaxePERCENTILE(expression, number)
DéfinitionRenvoie 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(Le lien s’ouvre dans une nouvelle fenêtre).

PI

SyntaxePI()
RésultatNombre
DéfinitionRenvoie la constante numérique PI : 3.14159...
Exemple
PI() = 3.14159
RemarquesUtile pour les fonctions trigonométriques dont les données sont exprimées en radians.

POWER

SyntaxePOWER(number, power)
RésultatNombre
DéfinitionÉlève le <number> à la <power> indiquée.
Exemple
POWER(5,3) = 125
POWER([Temperature], 2)
RemarquesVous pouvez également utiliser le symbole ^, par exemple, 5^3 = POWER(5,3) = 125

Voir aussi EXP, LOG et SQUARE.

PREVIOUS_VALUE

PREVIOUS_VALUE(expression)

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

PROPER

SyntaxePROPER(string)
RésultatChaî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.

retour en haut

Q

Trimestre

SyntaxeQUARTER(date)
RésultatEntier
DéfinitionRenvoie le trimestre d’une <date> donnée sous la forme d’un entier.
Exemple
QUARTER(#1986-03-25#) = 1
RemarquesVoir aussi DAY, WEEK, MONTH, YEAR et les équivalents ISO

retour en haut

R

RADIANS

SyntaxeRADIANS(number)
RésultatNombre (angle en radians)
DéfinitionConvertit en radians un <number> exprimé en degrés.
Exemple
RADIANS(180) = 3.14159
RemarquesLa fonction inverse, DEGREES, utilise un angle exprimé en radians et le renvoie en degrés.

RANK Fonctions de calcul de table

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

  • RANK(expression, ['asc' | 'desc'])
  • RANK_DENSE(expression, ['asc' | 'desc'])
  • RANK_MODIFIED(expression, ['asc' | 'desc'])
  • RANK_PERCENTILE(expression, ['asc' | 'desc'])
  • RANK_UNIQUE(expression, ['asc' | 'desc'])

Fonctions RAWSQL

Pour plus d’information, consultez Fonctions directes (RAWSQL)(Le lien s’ouvre dans une nouvelle fenêtre).

  • RAWSQL_BOOL("sql_expr", [arg1], … [argN])
  • RAWSQL_DATE("sql_expr", [arg1], … [argN])
  • RAWSQL_DATETIME("sql_expr", [arg1], … [argN])
  • RAWSQL_INT("sql_expr", [arg1], … [argN])
  • RAWSQL_REAL("sql_expr", [arg1], … [argN])
  • RAWSQL_SPATIAL
  • RAWSQL_STR("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_BOOL("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_DATE("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_DATETIME("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_INT("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_REAL("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_STR("sql_expr", [arg1], … [argN])

Fonctions REGEXP

Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

  • REGEXP_EXTRACT(string, pattern)
  • REGEXP_EXTRACT_NTH(string, pattern, index)
  • REGEXP_EXTRACT_NTH(string, pattern, index)
  • REGEXP_MATCH(string, pattern)
  • REGEXP_REPLACE(string, pattern, replacement)

REPLACE

SyntaxeREPLACE(string, substring, replacement
RésultatChaîne
DéfinitionRecherche 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"
RemarquesVoir aussi la fonction REGEXP_REPLACE dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).
SyntaxeRIGHT(string, number)
RésultatChaîne
DéfinitionRenvoie les caractères <number> situés le plus à droite dans la chaîne.
Exemple
RIGHT("Calculation", 4) = "tion"
RemarquesVoir également LEFT et MID.

ROUND

SyntaxeROUND(number, [decimals])
RésultatNombre
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 la valeur 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.

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.

RTRIM

SyntaxeRTRIM(string)
RésultatChaîne
DéfinitionRenvoie la <string> fournie en supprimant les espaces de fin.
Exemple
RTRIM(" Calculation ") = " Calculation"
RemarquesVoir également LTRIM et TRIM.

RTRIM_THIS

RTRIM_THIS(string, string)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

RUNNING Fonctions de calcul de table

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

  • RUNNING_AVG(expression)
  • RUNNING_COUNT(expression)
  • RUNNING_MAX(expression)
  • RUNNING_MIN(expression)
  • RUNNING_SUM(expression)

retour en haut

S

SCRIPT Extensions d’analytique

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

  • SCRIPT_BOOL
  • SCRIPT_INT
  • SCRIPT_REAL
  • SCRIPT_STR

SHAPETYPE

SyntaxeSHAPETYPE(<geometry>)
RésultatChaîne
DéfinitionRenvoie une chaîne décrivant la structure de la géométrie spatiale, par exemple Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed et Unsupported
Exemple
SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

SIGN

SyntaxeSIGN(number)
Résultat-1, 0 ou 1
DéfinitionRenvoie 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
RemarquesVoir aussi ABS.

SIN

SyntaxeSIN(number)
RésultatNombre
DéfinitionRenvoie le sinus d’un angle en radians.
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.

SIZE

SIZE()

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

SPACE

SyntaxeSPACE(number)
RésultatChaîne (en particulier, juste des espaces)
DéfinitionRenvoie une chaîne constituée du nombre spécifié d’espaces répétés.
Exemple
SPACE(2) = "  "

SPLIT

SyntaxeSPLIT(string, delimiter, token number)
RésultatChaîne
DéfinitionRenvoie une sous-chaîne à partir d’une <string>, à l’aide d’un caractère <delimiter> pour diviser la chaîne en une séquence de <tokens>.
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(Le lien s’ouvre dans une nouvelle fenêtre).

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.

SQRT

SyntaxeSQRT(number)
RésultatNombre
DéfinitionRenvoie la racine carrée d’un <number>.
Exemple
SQRT(25) = 5
RemarquesVoir aussi SQUARE.

SQUARE

SyntaxeSQUARE(number)
RésultatNombre
DéfinitionRenvoie le carré d’un <number>.
Exemple
SQUARE(5) = 25
RemarquesVoir aussi SQRT et POWER.

STARTSWITH

SyntaxeSTARTSWITH(string, substring)
RésultatBooléen
DéfinitionRenvoie true si string commence par substring. Les espaces en début de chaîne sont ignorés.
Exemple
STARTSWITH("Matador, "Ma") = TRUE
RemarquesVoir aussi CONTAINS, ainsi que la fonction REGEX prise en charge dans la documentation des fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

STDEV

SyntaxeSTDEV(expression)
DéfinitionRenvoie l’écart-type statistique de toutes les valeurs dans l’<expression> donnée en fonction d’un échantillon de population.

STDEVP

SyntaxeSTDEVP(expression)
DéfinitionRenvoie l’écart-type statistique de toutes les valeurs dans l’<expression> donnée en fonction d’une population biaisée.

STR

SyntaxeSTR(expression)
RésultatChaîne
DéfinitionConvertit l’argument en chaîne.
Exemple
STR([ID])

SUM

SyntaxeSUM(expression)
DéfinitionRenvoie la somme de toutes les valeurs de l’<expression>. Les valeurs nulles sont ignorées.
RemarquesLa valeur SUM peut être utilisée uniquement avec des champs numériques.

retour en haut

T

TAN

SyntaxeTAN(number)

L’argument <number> est l’angle exprimé en radians.

RésultatNombre
DéfinitionRenvoie la tangente d’un angle.
Exemple
TAN(PI ( )/4) = 1.0
RemarquesVoir aussi ATAN, ATAN2,COT et PI. Pour convertir un angle de degrés en radians, utilisez RADIANS.

THEN

SyntaxeIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
DéfinitionPartie 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

TIMESTAMP_TO_USEC

TIMESTAMP_TO_USEC(expression)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

TLD

TLD(string_url)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

TODAY

SyntaxeTODAY()
RésultatDate
DéfinitionRenvoie 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.

TOTAL

TOTAL(expression)

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

TRIM

SyntaxeTRIM(string)
RésultatChaîne
DéfinitionRenvoie la <string> fournie en supprimant les espaces de début et de fin.
Exemple
TRIM(" Calculation ") = "Calculation"
RemarquesVoir également LTRIM et RTRIM.

retour en haut

U

UPPER

SyntaxeUPPER(string)
RésultatChaîne
DéfinitionRenvoie la <string> fournie en caractères tout en majuscules.
Exemple
UPPER("Calculation") = "CALCULATION"
RemarquesVoir également PROPER et LOWER.

USEC_TO_TIMESTAMP

USEC_TO_TIMESTAMP(expression)

Pris en charge uniquement lorsque connecté à Google BigQuery. Pour plus d’information, consultez Fonctions supplémentaires(Le lien s’ouvre dans une nouvelle fenêtre).

USERDOMAIN

SyntaxeUSERDOMAIN( )
RésultatChaîne
DéfinitionRenvoie 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

SyntaxeUSERNAME( )
RésultatChaîne
DéfinitionRenvoie 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.

USER ATTRIBUTE JSON Fonctions du jeton Web

  • USERATTRIBUTE('attribute_name')
  • USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')

Pour plus d’information, consultez Fonctions utilisateur(Le lien s’ouvre dans une nouvelle fenêtre).

retour en haut

V

VAR

SyntaxeVAR(expression)
DéfinitionRenvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population.

VARP

SyntaxeVARP(expression)
DéfinitionRenvoie la variance statistique de toutes les valeurs dans l’expression donnée de la totalité de la population.

retour en haut

W

WEEK

SyntaxeWEEK(date)
RésultatEntier
DéfinitionRenvoie la semaine d’une <date> donnée sous la forme d’un entier.
Exemple
WEEK(#1986-03-25#) = 13
RemarquesVoir aussi DAY, MONTH, Trimestre, YEAR et les équivalents ISO

WHEN

SyntaxeCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
DéfinitionPartie 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.

Calculs de table de volet

Pour plus d’information, consultez Fonctions de calcul de table(Le lien s’ouvre dans une nouvelle fenêtre).

  • WINDOW_AVG(expression, [start, end])
  • WINDOW_CORR(expression1, expression2, [start, end])
  • WINDOW_COUNT(expression, [start, end])
  • WINDOW_COVAR(expression1, expression2, [start, end])
  • WINDOW_COVARP(expression1, expression2, [start, end])
  • WINDOW_MAX(expression, [start, end])
  • WINDOW_MEDIAN(expression, [start, end])
  • WINDOW_MIN(expression, [start, end])
  • WINDOW_PERCENTILE(expression, number, [start, end])
  • WINDOW_STDEV(expression, [start, end])
  • WINDOW_STDEVP(expression, [start, end])
  • WINDOW_SUM(expression, [start, end])
  • WINDOW_VAR(expression, [start, end])
  • WINDOW_VARP(expression, [start, end])

retour en haut

X

Fonctions XPATH.

Pris en charge uniquement lorsque connecté à Hadoop Hive. Pour plus d’information, consultez Fonctions directes (RAWSQL)(Le lien s’ouvre dans une nouvelle fenêtre).

  • XPATH_BOOLEAN(XML string, XPath expression string)
  • XPATH_DOUBLE(XML string, XPath expression string)
  • XPATH_FLOAT(XML string, XPath expression string)
  • XPATH_INT(XML string, XPath expression string)
  • XPATH_LONG(XML string, XPath expression string)
  • XPATH_SHORT(XML string, XPath expression string)
  • XPATH_STRING(XML string, XPath expression string)

retour en haut

Y

YEAR

SyntaxeYEAR(date)
RésultatEntier
DéfinitionRenvoie l’année d’une <date> donnée sous la forme d’un entier.
Exemple
YEAR(#1986-03-25#) = 1,986
RemarquesVoir aussi DAY, WEEK, MONTH, Trimestre et les équivalents ISO

retour en haut

Z

ZN

SyntaxeZN(expression)
RésultatDépend du type de données de l’<expression> ou de la valeur 0.
DéfinitionRenvoie <expression> si celle-ci n’est pas une valeur 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.

retour en haut

Voir également

Fonctions de Tableau (par catégorie)(Le lien s’ouvre dans une nouvelle fenêtre)

Fonctions dans Tableau(Le lien s’ouvre dans une nouvelle fenêtre)

Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!