Fonctions de nombre

S’applique à : Tableau Cloud, Tableau Desktop, Tableau Public, Tableau Server

Cet article présente les fonctions de nombre et leurs utilisations dans Tableau. Il montre également comment créer un calcul de nombre en utilisant un exemple.

Pourquoi utiliser des fonctions de nombre

Les fonctions de nombre vous permettent d’effectuer des calculs sur les valeurs de données qui se trouvent dans vos champs. Les fonctions de nombre peuvent uniquement être utilisées avec les champs contenant des valeurs numériques. Pour plus d’informations, consultez Types de données.

Par exemple, vous pouvez avoir un champ qui contient des valeurs pour la variance dans votre budget, intitulé Variance de budget. L’une des ces valeurs peut être -7. Vous pouvez utiliser la fonction ABS pour renvoyer la valeur absolue de ce nombre, et tous les autres nombres de ce champ.

Le calcul peut se présenter ainsi :

ABS[Budget Variance]

Et pour cette valeur -7, le résultat serait 7.

Fonctions de nombre disponibles dans Tableau

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 pour tous les nombres contenus dans le champ Budget Variance.
Remarques	Voir également `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`, prend l’angle 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`, prend l’angle 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`, prend l’angle en radians comme argument et renvoie la tangente. Voir également `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 également `ATAN`, `TAN` et `COT`.

CEILING

Syntaxe	`CEILING(number)`
Résultat	Entier
Définition	Arrondit un `<number>` au chiffre entier le plus proche d’une valeur supérieure ou égale.
Exemple	CEILING(2.1) = 3
Remarques	Voir également `FLOOR` et `ROUND`.
Limitations de la base de données	`CEILING` est disponible via les 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, MapR Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

COS

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

COT

Syntaxe	`COT(number)` L’argument numérique est l’angle en radians.
Résultat	Nombre
Définition	Renvoie la cotangente d’un angle.
Exemple	COT(PI( ) /4) = 1
Remarques	Voir également `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 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`, prend un angle en degrés et renvoie l’angle en radians. Voir également `PI()`.

DIV

Syntaxe	`DIV(integer1, integer2)`
Résultat	Entier
Définition	Retourne la part d’entier d’une opération de division, où `<integer1>` est 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 également `LN`.

FLOOR

Syntaxe	`FLOOR(number)`
Résultat	Entier
Définition	Arrondit un nombre au t `<number>` le plus proche de valeur inférieure ou égale.
Exemple	FLOOR(7.9) = 7
Remarques	Voir également `CEILING` et `ROUND`.
Limitations de la base de données	`FLOOR` est disponible via les connecteurs suivants : Microsoft Excel, fichier texte, fichier de statistiques, sources de données publiées, Amazon EMR Hadoop Hive, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, MapR 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 les coordonnées 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 classes 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 clustering 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 également `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 également `EXP` et `LOG`.

LOG

Syntaxe	`LOG(number, [base])` Si l’argument de base facultatif n’est pas présent, 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 également `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 null.
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 en tant qu’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 `MAX` est généralement la valeur qui vient en dernier dans l’ordre alphabétique. Pour les sources de données de base de données, la valeur de la chaîne `MAX` est la valeur 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, `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. En tant qu’agrégation `MAX(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Elle s’affiche sous la forme `AGG(expression)` dans la visualisation. En tant que comparaison `MAX(expr1, expr2)` compare les deux valeurs et renvoie une valeur au niveau des lignes. Voir également `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 null.
Définition	Renvoie la valeur minimum des deux arguments, qui doivent être du même type de données. `MIN` peut également être appliqué à un seul champ en tant qu’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 `MIN` est généralement la valeur qui vient en premier dans l’ordre alphabétique. Pour les sources de données de base de données, la valeur de la chaîne `MIN` est la valeur la plus faible dans la séquence de tri définie par la base de données pour cette colonne. Pour les dates Pour les dates, `MIN` est la date la plus récente. 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. En tant qu’agrégation `MIN(expression)` est une fonction d’agrégation et renvoie un seul résultat agrégé. Elle s’affiche sous la forme `AGG(expression)` dans la visualisation. En tant que comparaison `MIN(expr1, expr2)` compare les deux valeurs et renvoie une valeur au niveau des lignes. Voir également `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 qui prennent leur entrée en radians. Voir également `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 également `EXP`, `LOG` et `SQUARE`.

RADIANS

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

ROUND

Syntaxe	`ROUND(number, [decimals])`
Résultat	Nombre
Définition	Arrondit le `<number>` au nombre de chiffres spécifié. 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 au nombre 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 un nombre 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 flottant (par exemple 9,405 arrondi à 9,40). Il peut donc être préférable de formater le nombre avec le nombre de décimales souhaité plutôt que d’arrondir. Le formatage de 9,405 à deux décimales donnera le nombre 9,41 attendu. Voir également `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 également `ABS`.

SIN

Syntaxe	`SIN(number)` L’argument numérique est l’angle 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`, prend le sinus comme argument et renvoie l’angle en radians. Voir également `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 également `SQUARE`.

SQUARE

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

TAN

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

ZN

Syntaxe	`ZN(expression)`
Résultat	N’importe lequel, ou o
Définition	Renvoie l’`<expression>` si ce n’est pas une valeur null ; sinon renvoie la valeur zéro. Utilisez cette fonction pour remplacer les valeurs null par des zéros.
Exemple	ZN(Grade) = 0
Remarques	Il s’agit d’une fonction très utile lors de l’utilisation de champs pouvant contenir des valeurs null dans un calcul. Entourer le champ avec `ZN` peut éviter les erreurs causées par les calculs avec des valeurs null.

Créer un de calcul de nombre

Suivez les étapes ci-dessous pour apprendre à créer un calcul de nombre.

Dans Tableau Desktop, connectez-vous à la source de données Exemple - Hypermarché enregistrée qui est fournie avec Tableau.
Accédez à une feuille de calcul et sélectionnez Analyse > Créer un champ calculé.
Dans l’éditeur de calcul qui s’ouvre, procédez comme suit :

Nommez le champ calculé Transaction de vente minimum
Entrez la formule suivante :
MIN(Sales)
Lorsque vous avez terminé, cliquez sur OK.

Le nouveau calcul de nombre apparaît sous Mesures dans le volet Données. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations.

Lorsque Ventes minimum est placé sur Texte sur la fiche Repères dans la feuille de calcul, son nom est changé en AGG(Ventes minimum). Cela indique qu’il ne peut pas être agrégé davantage, puisqu’il est déjà agrégé jusqu’au niveau de détail le plus faible (la valeur de ventes la plus petite pour tous les enregistrements).

Cet exemple montre les ventes minimum par catégorie.