Référence des fonctions de Tableau Prep

Les fonctions de calcul de Tableau Prep vous permettent d’utiliser les champs calculés pour créer de nouvelles données en utilisant les données déjà présentes dans votre source de données.

Fonctions de nombre

SyntaxeDescription
ABS(number)Renvoie la valeur absolue d’un nombre donné.

Exemples :

ABS(-7) = 7

ABS([Budget Variance])

Renvoie la valeur absolue pour tous les nombres contenus dans le champ Budget Variance.
ACOS(number)Renvoie l’arc cosinus d’un nombre donné. Le résultat est exprimé en radians.

Exemple :

ACOS(-1) = 3.14159265358979

ASIN(number)Renvoie l’arc sinus d’un nombre donné. Le résultat est exprimé en radians.

Exemple :

ASIN(1) = 1.5707963267949

ATAN(number)Renvoie l’arc tangente d’un nombre donné. Le résultat est exprimé en radians.

Exemple :

ATAN(180) = 1.5652408283942

ATAN2(y number, x number)Renvoie l’arc tangente de deux nombres donnés (x et y). Le résultat est exprimé en radians.

Exemple :

ATAN2(2, 1) = 1.10714871779409

CEILING(number)Arrondit un nombre à l’entier le plus proche d’une valeur supérieure ou égale.

Exemple :

CEILING(3.1415) = 4

COS(number)Renvoie le cosinus d’un angle. Spécifiez l’angle en radians.

Exemple :

COS(PI( ) /4) = 0.707106781186548

COT(angle)Renvoie la cotangente d’un angle. Spécifiez l’angle en radians.

Exemple :

COT(PI( ) /4) = 1

DIV(integer1, integer2)Renvoie la partie d’entier d’une opération de division, où integer1 est divisé par integer2.

Exemple :

DIV(11,2) = 5

EXP(number)Renvoie la valeur e élevée à la puissance du nombre donné.

Exemples :

EXP(2) = 7.389 EXP(-[Growth Rate]*[Time])

FLOOR(number)Arrondit un nombre à l’entier le plus proche d’une valeur inférieure ou égale.

Exemple :

FLOOR(3.1415) = 3

HEXBINX(number, number)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], [Latitude])

HEXBINY(number, number)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], [Latitude])

LN(number)

Renvoie le logarithme naturel d’un nombre. Renvoie une valeur null si le nombre est inférieur ou égal à 0.

Exemple :

LN(EXP(5)) = 5

LOG(number [, base])

Renvoie le logarithme naturel d’un nombre pour la base donnée. Si la valeur de base n’est pas indiquée, la base 10 est utilisée.

Exemple :

LOG(256, 2) = 8

MAX(number, number)Renvoie la valeur maximum des deux arguments, qui doivent être du même type. Renvoie une valeur null si un des arguments est une valeur null. MAX peut également être appliqué à un seul champ dans un calcul d’agrégation.

Exemples :

MAX(4,7)
MAX(Sales,Profit)
MAX([First Name],[Last Name])

MIN(number, number)Renvoie la valeur minimum des deux arguments, qui doivent être du même type. Renvoie une valeur null si un des arguments est une valeur null. MIN peut également être appliqué à un seul champ dans un calcul d’agrégation.

Exemples :

MIN(4,7)

MIN(Sales,Profit)

MIN([First Name],[Last Name])

PI( )

Renvoie la constante numérique PI : 3.14159.

Exemple :

PI() = 3.14159265358979

POWER(number, power)Élève le nombre à la puissance indiquée.

Exemples :

POWER(5,2) = 52 = 25 POWER(Temperature, 2)

Vous pouvez également utiliser le symbole ^ :

5^2 = POWER(5,2) = 25

RADIANS(number)Convertit en radians un nombre donné exprimé en degrés.

Exemple :

RADIANS(180) = 3.14159

ROUND(number, [decimals])Arrondit les nombres à un nombre donné de chiffres. L’argument Décimales indique le nombre de points décimaux de précision à inclure dans le résultat final. Si les décimales sont omises, le nombre est arrondi à l’entier le plus proche.

Exemple :

Cet exemple arrondit toutes les valeurs Ventes à un entier :

ROUND(Sales)

SIGN(number)Renvoie le signe d’un nombre. 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 :

Si la moyenne du champ des profits est négative, alors

SIGN(AVG(Profit)) = -1

SIN(number)Renvoie le sinus d’un angle. Spécifiez l’angle en radians.

Exemples :

SIN(0) = 1.0

SIN(PI( )/4) = 0.707106781186548

SQRT(number)Renvoie la racine carrée d’un nombre.

Exemple :

SQRT(25) = 5

SQUARE(number)Renvoie le carré d’un nombre.

Exemple :

SQUARE(5) = 25

TAN(number)

Renvoie la tangente d’un angle. Spécifiez l’angle en radians.

Exemple :

TAN(PI ( )/4) = 1.0

ZN(expression)

Renvoie l’expression si celle-ci n’est pas nulle ; sinon renvoie la valeur zéro. Utilisez cette fonction pour utiliser des valeurs égales à zéro au lieu de valeurs nulles.

Exemple :

ZN([Profit]) = [Profit]

Fonctions de chaîne

SyntaxeDescription
ASCII(string)Renvoie le code ASCII du premier caractère d’une chaîne.

Exemple :

ASCII('A') = 65

CHAR(number)Renvoie le caractère encodé à l’aide du nombre du code ASCII.

Exemple :

CHAR(65) = 'A'

CONTAINS(string, substring)Renvoie TRUE si la chaîne donnée contient la sous-chaîne indiquée.

Exemple :

CONTAINS(“Calculation”, “alcu”) = true

ENDSWITH(string, substring)Renvoie TRUE si la chaîne donnée se termine par la substring indiquée. Les espaces en fin de chaîne sont ignorés.

Exemple :

ENDSWITH(“Tableau”, “leau”) = true

FIND(string, substring, [start])Renvoie la position d’index de la substring dans la chaîne, ou 0 si la sous-chaîne est introuvable. Si le début de l’argument facultatif est ajouté, la fonction ignore les instances de la substring qui apparaissent avant le début de la position d’index. Le premier caractère de la chaîne correspond à la position 1.

Exemples :

FIND("Calculation", "alcu") = 2

FINDNTH(string, substring, occurrence)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

ISDATE(string)

Renvoie la valeur vrai si une chaîne donnée est une date valide.

Exemple :

ISDATE("2004-04-15") = True

LEFT(string, number)Renvoie les caractères situés le plus à gauche dans la chaîne.

Exemple :

LEFT("Matador", 4) = "Mata"

LEN(string)Renvoie la longueur de la chaîne.

Exemple :

LEN("Matador") = 7

LOWER(string)Renvoie une chaîne avec tous les caractères en minuscules.

Exemple :

LOWER("ProductVersion") = "productversion"

LTRIM(string)Renvoie la chaîne en supprimant les espaces de début.

Exemple :

Example: LTRIM(" Sales") = "Sales"

(MID(string, start, [length])Renvoie la chaîne commençant au début de la position d’index. Le premier caractère de la chaîne correspond à la position 1. Si l’argument facultatif de longueur est ajouté, la chaîne renvoyée inclut uniquement ce nombre de caractères.

Exemples :

MID("Calculation", 2) = "alculation"

MID("Calculation", 2, 5) ="alcul"

PROPER(string)Convertit une chaîne de texte de manière à ce que la première lettre de chaque mot soit en majuscules et les autres lettres en minuscules. Les espaces et les caractères non alphanumériques tels que la ponctuation font également office de séparateurs.

Exemple :

PROPER("PRODUCT name") = "Product Name"

REGEXP_EXTRACT(string, pattern)Renvoie une sous-chaîne de la chaîne donnée qui correspond au groupe de capture dans le modèle d’expression régulière. Le modèle d’expression régulière nécessite exactement un groupe de capture

Exemple :

REGEXP_EXTRACT('abc 123', '[a-z]+\\s+(\\d+)') = '123'

REGEXP_EXTRACT_NTH(string, pattern, index)Renvoie une sous-chaîne de la chaîne donnée en utilisant le modèle d’expression régulière. La sous-chaîne est associée au n-ième groupe de capture, où n est l’index donné.

Exemple :

REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\\s+(\\d+)', 2) = '123'

REGEXP_MATCH(string, pattern)Renvoie TRUE si une sous-chaîne de la chaîne fournie correspond au modèle d’expression régulière.

Exemple :

REGEXP_MATCH('-([1234].[ The.Market ])-', '\\[\\s*(\\w*\\.)(\\w*\\s*\\])') = true

REGEXP_REPLACE(string, pattern, replacement)Renvoie une copie de la chaîne donnée où la chaîne de remplacement se substitue au modèle de correspondance.

Exemple :

REGEXP_REPLACE('abc 123', '\\s', '-') = 'abc--123'

REPLACE(string, substring, replacement)Recherche une sous-chaîne dans une chaîne et y substitue un remplacement. Si la sous-chaîne est introuvable, la chaîne reste inchangée.

Exemple :

REPLACE("Calculation", "ion", "ed") = "Calculated"

RIGHT(string, number)Renvoie les caractères situés le plus à droite dans une chaîne.

Exemple :

RIGHT("Calculation", 4) = "tion"

RTRIM(string)Renvoie la chaîne en supprimant les espaces de fin.

Exemple :

Example: RTRIM("Market ") = "Market"

SPACE(number)Renvoie une chaîne constituée du nombre spécifié d’espaces répétés.

Exemple :

SPACE(1) = " "

SPLIT(string, delimiter, token number)

Renvoie une sous-chaîne d’une chaîne, telle que déterminée par un délimiteur extrayant les caractères de début ou de fin de la chaîne.

Exemple :

SPLIT('a-b-c-d', '-', 2) = 'b'

STARTSWITH(string, substring)Renvoie true si la chaîne commence par substring. Les espaces en début de chaîne sont ignorés.

Exemple :

STARTSWITH(“Joker”, “Jo”) = true

TRIM(string)Renvoie la chaîne en supprimant les espaces de début et de fin.

Exemple :

TRIM(" Calculation ") = "Calculation"

UPPER(string)Renvoie la chaîne avec tous les caractères en majuscules.

Exemple :

UPPER("Calculation") = "CALCULATION"

Fonctions d’agrégation

SyntaxeDescription
AVG(expression)Renvoie la moyenne de toutes les valeurs de l’expression. La fonction AVG peut être utilisée avec des champs numériques uniquement. Les valeurs null sont ignorées

Exemple :

AVG([Profit])

COUNT(expression)Renvoie le nombre d’éléments d’un groupe. Les valeurs null sont ignorées.

Exemple :

COUNT([Customer ID])

COUNTD(expression)Renvoie le nombre d’éléments distincts d’un groupe. Les valeurs null sont ignorées. Chaque valeur unique n’est comptabilisée qu’une seule fois.

Exemple :

COUNTD([Region])

MEDIAN(expression)Renvoie la médiane d’une seule expression. La fonction MEDIAN peut être utilisée avec des champs numériques uniquement. Les valeurs null sont ignorées.

Exemple :

MEDIAN([Profit])

PERCENTILE(expression, number)Le calcul agrégé renvoie la valeur du centile pour l’expression donnée correspondant au nombre indiqué. Les valeurs valides pour le nombre vont de 0 à 1. PERCENTILE([expression], 0.50) renverra toujours la valeur médiane dans l’expression.

Exemple :

PERCENTILE([Sales], 0.90)

STDEV(expression)Renvoie l’écart-type d’échantillon dans l’expression.

Exemple :

STDEV([Profit])

STDEVP(expression)

Renvoie l’écart-type de population dans l’expression.

Exemple :

STDEVP([Profit])

SUM(expression)

Renvoie la somme de toutes les valeurs de l’expression. La fonction SUM peut être utilisée avec des champs numériques uniquement. Les valeurs null sont ignorées.

Exemple :

SUM([Profit])

VAR(expression)

Renvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population.

Exemple :

VAR([Profit])

VARP(expression)

Renvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population.

Exemple :

VARP([Profit])

ZN(expression)

Renvoie l’expression si celle-ci n’est pas nulle ; sinon renvoie la valeur zéro. Utilisez cette fonction pour utiliser des valeurs égales à zéro au lieu de valeurs nulles.

Exemple :

ZN([Profit]) = [Profit]

Fonctions de conversion de type

SyntaxeDescription
DATERenvoie une date en fonction d’un nombre, d’une chaîne ou d’une expression de date.

Exemple :

DATE("2006-06-15 14:52") = 2006-06-15

Notez que les guillemets sont obligatoires.

DATETIME(expression)Renvoie une date et une heure en fonction d’un nombre, d’une chaîne ou d’une expression de date.

Exemple :

DATETIME("April 15, 2004 07:59:00")

Notez que les guillemets sont obligatoires.

FLOAT(expression)Renvoie une valeur flottante selon une expression de tout type. Cette fonction nécessite des nombres non formatés, ce qui exclut donc les virgules et autres symboles.

Exemple :

FLOAT("3")= 3.000

INT(expression)Renvoie un entier selon une expression donnée. Cette fonction tronque le résultat au nombre entier le plus proche tendant vers zéro.

Exemple :

INT(8.0/3.0) = 2 or INT(-9.7) = -9

MAKEDATE(year, month, day)Renvoie une valeur de date créée à partir d’une année, d’un mois et d’un jour du mois.

Exemple :

MAKEDATE(2014, 3, 18)

MAKEDATETIME(date, time)

Renvoie une valeur de date et heure selon une expression de date et une expression d’heure.

Exemple :

MAKEDATETIME(#2012-11-12#, #07:59:00#)

MAKETIME(hour, minute, second)

Renvoie une valeur de temps créée à partir des heures, minutes et secondes.

Exemple :

MAKETIME(14, 52, 40)

STR(expression)

Renvoie une chaîne en fonction d’une expression donnée.

Exemple :

STR([Age])

Renvoie toutes les valeurs de la mesure Âge sous forme de chaînes.

Fonctions de date

SyntaxeDescription
DATEADD(date_part, interval, date)Ajoute un incrément à la date spécifiée et renvoie la nouvelle date. L’incrément est défini par l’intervalle et date_part.

Exemple :

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

DATEDIFF(date_part, start_date, end_date, [start_of_week])

Renvoie la différence entre deux dates où start_date est soustrait de end_date. La différence est exprimée en unités date_part. Si start_of_week est omis, le jour de début de la semaine est déterminé par le jour de début configuré pour la source de données.

Exemple :

DATEDIFF('month', #2004-07-15#, #2004-04-03#, 'sunday') = -3

DATENAME(date_part, date, [start_of_week])Renvoie une partie de la date donnée sous forme de chaîne où le partie est définie par date_part. Si start_of_week est omis, le jour de début de la semaine est déterminé par le jour de début configuré pour la source de données.

Exemple :

DATENAME('month', #2004-04-15#) = "April"

DATEPARSE(format, string)Convertit une chaîne en une date au format spécifié.

Exemple :

DATEPARSE ("dd.MMMM.yyyy", "15.April.2004") = 2004-04-15 12:00:00 AM

DATEPARTT(date_part, date, [start_of_week])Renvoie une partie de la date donnée sous forme d’entier où la partie est définie par date_part. Si start_of_week est omis, le jour de début de la semaine est déterminé par le jour de début configuré pour la source de données.

Exemple :

DATEPART('month', #2004-04-15#) = 4

DATETRUNC(date_part, date, [start_of_week])Tronque la date indiquée au niveau de précision indiqué par la valeur date_part et renvoie la nouvelle date. Si start_of_week est omis, le jour de début de la semaine est déterminé par le jour de début configuré pour la source de données.

Exemple :

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM

DAY(date)Renvoie le jour d’une date donnée sous la forme d’un entier.

Exemple :

DAY(#2004-04-12#) = 12

ISDATE(string)Renvoie la valeur vrai si une chaîne donnée est une date valide.

Exemple :

ISDATE("2004-04-15") = True

MONTH(date)

Renvoie le mois d’une date donnée sous la forme d’un entier.

Exemple :

MONTH(#2004-04-12#) = 4

NOW()Renvoie la date et l’heure actuelles.

Exemple :

NOW() = 2004-05-12 1:08:21 PM

TODAY()Renvoie la date actuelle.

Exemple :

TODAY() = 2004-05-12

YEAR(date)Renvoie l’année d’une date donnée sous la forme d’un entier.

Exemple :

YEAR(#2004-04-12#) = 2004

Fonctions logiques

SyntaxeDescription
IFNULL(expr1, expr2)Renvoie <expr1> si la valeur n’est pas null, sinon renvoie <expr2>.

Exemple :

IFNULL([Profit], 0)

IIF(test, then, else, [unknown])Vérifie si une condition est remplie, et renvoie une valeur si TRUE, une autre valeur si FALSE, et une troisième valeur optionnelle ou NULL si inconnu.

Exemple :

IIF([Profit] > 0, 'Profit', 'Loss')

ISDATE(string)Renvoie la valeur vrai si une chaîne donnée est une date valide.

Exemple :

ISDATE("2004-04-15") = True

ISNULL(expression)Renvoie true si l’expression ne contient pas de données valides (Null).

Exemple :

ISNULL([Profit])

ZN(expression)

Renvoie l’expression si celle-ci n’est pas nulle ; sinon renvoie la valeur zéro. Utilisez cette fonction pour utiliser des valeurs égales à zéro au lieu de valeurs nulles.

Exemple :

ZN([Profit]) = [Profit]

Fonctions analytiques

SyntaxeDescription
LAST_VALUE(expression, [return_last_non-null_value])Renvoie la dernière valeur de l’expression donnée, de la première ligne de la partition à la ligne actuelle. Accepte un deuxième paramètre booléen facultatif pour renvoyer la dernière valeur non null.

Exemple :

{ ORDERBY [Row ID] ASC: LAST_VALUE([Category], true) } = returns the last non-null value of [Category]

LOOKUP(expression, [offset])

Renvoie la valeur de l’expression donnée dans une ligne cible, indiquée sous la forme d’un décalage relatif par rapport à la ligne actuelle. Renvoie NULL si la ligne cible ne peut pas être déterminée.

Le paramètre [offset] de la fonction LOOKUP ne peut prendre en charge qu’un entier littéral tel que 1.

Exemple :

{ORDERBY [DATE] ASC : LOOKUP([SALES], -1)}

Renvoie la valeur SALES de la ligne précédente.

NTILE(number)Distribue les lignes d’une partition sélectionnée dans un nombre spécifié de groupes ou de sections. Avec cette fonction, l’ensemble des valeurs (6,9,9,14) réparties sur 3 sections serait attribué aux sections (1,2,2,3) dans l’ordre croissant.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: NTILE(3) }}

RANK()Renvoie le rang concurrentiel standard de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK() }}

RANK_DENSE()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.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_DENSE() }}

RANK_MODIFIED()Renvoie le rang concurrentiel modifié de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_MODIFIED() }}

RANK_PERCENTILE()Renvoie le rang centile de la ligne actuelle de la partition.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: RANK_PERCENTILE() }}

ROW_NUMBER()Attribue un identifiant de ligne séquentiel unique à chaque ligne.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales] ASC: ROW_NUMBER() }}

RUNNING_AVG(expression)Renvoie la moyenne cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle.

Exemple :

{ PARTITION [Category] : { ORDERBY [Row ID] ASC : RUNNING_AVG([Sales]) } } = running average of Sales, per Category.

RUNNING_SUM(expression)Renvoie la somme cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle.

Exemple :

{ ORDERBY [Row ID] ASC : RUNNING_SUM([Sales]) } = running sum of all Sales

Mots-clés

FonctionDescription
ANDRéalise une conjonction logique entre deux expressions

Exemple :

IF (ATTR([Market]) = "New Business" AND SUM([Sales]) > [Emerging Threshold] )THEN "Well Performing"

ASCDéfinit l’ordre croissant pour les opérations ORDERBY .

Exemple

{ORDERBY [Sales] ASC:RANK()}

CASETrouve la première value correspondant à <expr et renvoie la valeur return correspondante.

Exemple :

CASE [RomanNumeral] WHEN "|" THEN 1 WHEN "II" THEN 2 ELSE 3 END

DESCDéfinit l’ordre décroissant pour les opérations ORDERBY .

Exemple :

{ORDERBY [Sales] DESC:RANK()}

ELSETeste une série d’expressions et renvoie la valeur then pour la première <expr> vraie.

Exemple :

IF [Profit] > 0 THEN 'Profitable' ELSE 'Loss' END

ELSEIFTeste une série d’expressions et renvoie la valeur then pour la première <expr> vraie. Équivaut à placer une instruction if à l’intérieur d’une opération ELSE.

Exemple :

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

ENDTermine une opération introduite par la directive correspondante.

Exemple :

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

{ FIXED }Les expressions de niveau de détail FIXED calculent des valeurs en utilisant les dimensions spécifiées sans faire référence au niveau de détail de la vue.

Exemple :

{FIXED[Customer ID]:MIN([Order Date])}

IFCrée une instruction conditionnelle (instruction IF) et vous permet de l’exécuter uniquement si une condition est vraie.

Exemple :

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Breakeven' ELSE 'Loss' END

NOTApplique une négation logique sur une expression.

Exemple :

IF NOT [Profit] > 0 THEN "Unprofitable" END

ORApplique une disjonction logique sur une expression.

Exemple :

IF [Profit] < 0 OR [Profit] = 0 THEN "Needs Improvement" END

{ ORDERBY }Définit l’ordre d’application des fonctions analytiques. Utilisez l’argument facultatif asc | desc pour spécifier l’ordre croissant ou décroissant pour chaque champ.

Exemple :

{ORDERBY [Customer Name] ASC, [Sales] DESC: RANK() }

{ PARTITION }Définit le groupe auquel appliquer les fonctions analytiques. ORDERBY doit être à l’intérieur de la partition.

Exemple :

{PARTITION [Customer]: {ORDERBY [Sales]: RANK()}}

THENTeste une série d’expressions et renvoie la valeur then pour la première <expr> vraie.

Exemple :

IF [Profit] > 0 THEN 'Profitable' ELSEIF [Profit] = 0 THEN 'Break even' ELSE 'unprofitable' END

WHENTrouve la première <value> correspondant à <expr> et renvoie la valeur <return> correspondante.

Exemple :

CASE [RomanNumberal] WHEN 'I' THEN 1 WHEN 'II' THEN 2 ELSE 3 END

Merci de vos commentaires !Avis correctement envoyé. Merci