Référence des fonctions de Tableau Prep
Les fonctions de calcul de Tableau Prep vous permettent d’utiliser des 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
| Syntaxe | Description |
|---|---|
ABS(number) | Renvoie la valeur absolue d’un nombre donné. Exemples :
|
ACOS(number) | Renvoie l’arc cosinus d’un nombre donné. Le résultat est exprimé en radians. Exemple :
|
ASIN(number) | Renvoie l’arc sinus d’un nombre donné. Le résultat est exprimé en radians. Exemple :
|
ATAN(number) | Renvoie l’arc tangente d’un nombre donné. Le résultat est exprimé en radians. Exemple :
|
ATAN2(y number, x number) | Renvoie l’arc tangente de deux nombres données (x et y). Le résultat est exprimé en radians.Exemple :
|
CEILING(number) | Arrondit un chiffre au chiffre entier le plus proche ou à la valeur la plus importante. Exemple :
|
COS(number) | Renvoie le cosinus d’un angle. Spécifiez l’angle en radians. Exemple :
|
COT(angle) | Renvoie la cotangente d’un angle. Spécifiez l’angle en radians. Exemple :
|
DIV(integer1, integer2) | Retourne la part d’entier d’une opération de division, à savoir integer1 divisé par integer2.Exemple :
|
EXP(number) | Renvoie la valeur e élevée à la puissance du nombre donné. Exemples :
|
FLOOR(number) | Arrondit un nombre au nombre entier le plus proche de valeur inférieure ou égale. Exemple :
|
HEXBINX(number, number) | Mappe des coordonnées x, y sur la coordonnée x de la classe hexagonale la plus proche. Les classes ayant une longueur latérale de 1, il est possible que vous deviez dimensionner les entrées. Exemple :
|
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 :
|
LN(number) | Renvoie le logarithme naturel d’un nombre. Renvoie la valeur nulle si le nombre est inférieur ou égal à 0. Exemple :
|
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 :
|
MAX(number, number) | Renvoie la valeur maximum des deux arguments, qui doivent être du même type. Renvoie une valeur nulle si la valeur de l’un ou l’autre argument est nulle. MAX peut également être appliqué à un seul champ dans un calcul d’agrégation.Exemples :
|
MIN(number, number) | Renvoie la valeur minimum des deux arguments, qui doivent être du même type. Renvoie une valeur nulle si la valeur de l’un ou l’autre argument est nulle. MIN peut également être appliqué à un seul champ dans un calcul d’agrégation.Exemples :
|
PI( ) | Renvoie la constante numérique PI : 3.14159. Exemple :
|
POWER(number, power) | Élève le nombre à la puissance indiquée. Exemples :
Vous pouvez également utiliser le symbole ^ :
|
RADIANS(number) | Convertit en radians un nombre donné exprimé en degrés. Exemple :
|
ROUND(number, [decimals]) | Arrondit les nombres à un nombre donné de chiffres. L’argument Décimale indique le nombre de points décimaux de précision à inclure dans le résultat final. Si la valeur Décimale n’est pas indiquée, le nombre est arrondi à l’entier le plus proche. Exemple : Cet exemple arrondit toutes les valeurs de vente à un entier :
|
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
|
SIN(number) | Renvoie le sinus d’un angle. Spécifiez l’angle en radians. Exemples :
|
SQRT(number) | Renvoie la racine carrée d’un nombre. Exemple :
|
SQUARE(number) | Renvoie le carré d’un nombre. Exemple :
|
TAN(number) | Renvoie la tangente d’un angle. Spécifiez l’angle en radians. Exemple :
|
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 :
|
Fonctions de chaîne
| Syntaxe | Description |
|---|---|
ASCII(string) | Renvoie le code ASCII du premier caractère d’une chaîne. Exemple :
|
CHAR(number) | Renvoie le caractère encodé à l’aide du nombre du code ASCII. Exemple :
|
CONTAINS(string, substring) | Renvoie TRUE si la chaîne donnée contient la sous-chaîne indiquée. Exemple :
|
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 :
|
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 l’argument facultatif Début est ajouté, la fonction ignore les instances de la substring qui apparaissent avant la première position d’index. Le premier caractère de la chaîne correspond à la position 1.Exemples :
|
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 :
|
ISDATE(string) | Renvoie la valeur vrai si une chaîne donnée est une date valide. Exemple :
|
LEFT(string, number) | Renvoie les caractères situés le plus à gauche dans la chaîne. Exemple :
|
LEN(string) | Renvoie la longueur de la chaîne. Exemple :
|
LOWER(string) | Renvoie la chaîne avec tous les caractères en minuscules. Exemple :
|
LTRIM(string) | Renvoie la chaîne en supprimant les espaces de début. Exemple :
|
(MID(string, start, [length]) | Renvoie la chaîne débutant à la première position d’index. Le premier caractère de la chaîne correspond à la position 1. Si l’argument facultatif longueur est ajouté, la chaîne renvoyée inclut uniquement ce nombre de caractères. Exemples :
|
PROPER(string) | Convertit une chaîne de texte de sorte que la première lettre de chaque mot soit en majuscule et les lettres restantes en minuscules. Les espaces et les caractères non alphanumériques tels que la ponctuation agissent également comme séparateurs. Exemple :
|
REGEXP_EXTRACT(string, pattern) | Renvoie une sous-chaîne de la chaîne donnée qui est associée au groupe de capture dans le modèle d’expression régulière. Le modèle d’expression régulière requiert exactement un groupe de capture Exemple :
|
REGEXP_EXTRACT_NTH(string, pattern, index) | Renvoie une sous-chaîne de la chaîne donnée à l’aide du modèle d’expression régulière. La sous-chaîne est associée au nth groupe de capture, où n est l’index donné. Exemple :
|
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_REPLACE(string, pattern, replacement) | Renvoie une copie de la chaîne donnée où le modèle de correspondance est remplacé par la chaîne de remplacement. Exemple :
|
REPLACE(string, substring, replacement) | Recherche la sous-chaîne dans la chaîne et la remplace par la chaîne de remplacement. Si la sous-chaîne est introuvable, la chaîne reste inchangée. Exemple :
|
RIGHT(string, number) | Renvoie les caractères situés le plus à droite dans la chaîne. Exemple :
|
RTRIM(string) | Renvoie la chaîne en supprimant les espaces de fin. Exemple :
|
SPACE(number) | Renvoie une chaîne constituée du nombre spécifié d’espaces répétés. Exemple :
|
SPLIT(string, delimiter, token number)
| Renvoie une sous-chaîne d’une chaîne, déterminée par un délimiteur qui extrait les caractères du début ou de la fin de la chaîne. Exemple :
|
STARTSWITH(string, substring) | Renvoie true si la chaîne commence par une substring. Les espaces en début de chaîne sont ignorés.Exemple :
|
TRIM(string) | Renvoie la chaîne en supprimant les espaces de début et de fin. Exemple :
|
UPPER(string) | Renvoie la chaîne avec tous les caractères en majuscules. Exemple :
|
Fonctions d’agrégation
| Syntaxe | Description |
|---|---|
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 nulles sont ignorées Exemple :
|
COUNT(expression) | Renvoie le nombre d’éléments d’un groupe. Les valeurs nulles sont ignorées. Exemple :
|
COUNTD(expression) | Renvoie le nombre d’éléments distincts d’un groupe. Les valeurs nulles sont ignorées. Chaque valeur unique n’est comptabilisée qu’une seule fois. Exemple :
|
MEDIAN(expression) | Renvoie la médiane d’une expression unique. La fonction MEDIAN peut être utilisée avec des champs numériques uniquement. Les valeurs nulles sont ignorées. Exemple :
|
PERCENTILE(expression, number) | Calcul agrégé qui renvoie la valeur du centile pour l’expression donnée correspondant au nombre indiqué. Les valeurs valides pour le nombre sont comprises entre 0 et 1. CENTILE([expression], 0,50) renvoie toujours la valeur médiane de l’expression. Exemple :
|
STDEV(expression) | Renvoie l’écart-type d’échantillon de l’expression. Exemple :
|
STDEVP(expression) | Renvoie l’écart-type de population de l’expression. Exemple :
|
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 nulles sont ignorées. Exemple :
|
VAR(expression) | Renvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population. Exemple :
|
VARP(expression) | Renvoie la variance statistique de toutes les valeurs dans l’expression donnée en fonction d’un échantillon de population. Exemple :
|
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 :
|
Fonctions de conversion de type
| Syntaxe | Description |
|---|---|
DATE | Renvoie une date en fonction d’un nombre, d’une chaîne ou d’une expression de date. Exemple :
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 :
Notez que les guillemets sont obligatoires. |
FLOAT(expression) | Renvoie un nombre à virgule flottante en fonction de tout type d’expression. Cette fonction requiert des nombres non formatés, c’est-à-dire sans virgules ni autres symboles. Exemple :
|
INT(expression) | Renvoie un entier en fonction d’une expression. Cette fonction tronque le résultat à l’entier le plus proche de zéro. Exemple :
|
MAKEDATE(year, month, day) | Renvoie une valeur de date créée à partir de l’année du mois et du jour du mois. Exemple :
|
MAKEDATETIME(date, time) | Renvoie une valeur de date et heure en fonction d’une expression de date et d’une expression d’heure. Exemple :
|
MAKETIME(hour, minute, second) | Renvoie une valeur d’heure créée à partir des heures, des minutes et des secondes. Exemple :
|
STR(expression) | Renvoie une chaîne en fonction d’une expression. Exemple :
Renvoie toutes les valeurs de la mesure de l’âge sous forme de chaînes. |
Fonctions de date
| Syntaxe | Description |
|---|---|
DATEADD(date_part, interval, date) | Ajoute un incrément à la date indiquée et renvoie la nouvelle date. L’incrément est défini par l’intervalle et la valeur de date_part. Exemple :
|
DATEDIFF(date_part, start_date, end_date, [start_of_week]) | Renvoie la différence entre deux dates où la valeur start_date est soustraite de la valeur end_date. La différence est exprimée en unités de date_part. Si la valeur start_of_week est omise, le jour de début de semaine est déterminé par le jour de début configuré pour la source de données. Exemple :
|
DATENAME(date_part, date, [start_of_week]) | Renvoie une partie de la data donnée sous forme de chaîne, la partie étant définie en fonction de la valeur date_part. Si la valeur start_of_week est omise, le jour de début de semaine est déterminé par le jour de début configuré pour la source de données. Exemple :
|
DATEPARSE(format, string) | Convertit une chaîne en date dans le format spécifié. Exemple :
|
DATEPARTT(date_part, date, [start_of_week]) | Renvoie une partie de la data donnée sous forme d’entier, la partie étant définie en fonction de la valeur date_part. Si la valeur start_of_week est omise, le jour de début de semaine est déterminé par le jour de début configuré pour la source de données. Exemple :
|
DATETRUNC(date_part, date, [start_of_week]) | Tronque la date indiquée au niveau indiqué par la valeur date_part et renvoie la nouvelle date. Si la valeur start_of_week est omise, le jour de début de semaine est déterminé par le jour de début configuré pour la source de données. Exemple :
|
DAY(date) | Renvoie le jour d’une date donnée sous la forme d’un entier. Exemple :
|
ISDATE(string) | Renvoie la valeur vrai si une chaîne donnée est une date valide. Exemple :
|
MONTH(date) | Renvoie le mois d’une date donnée sous la forme d’un entier. Exemple :
|
NOW() | Renvoie la date et l’heure actuelles. Exemple :
|
TODAY() | Renvoie la date actuelle. Exemple :
|
YEAR(date) | Renvoie l’année d’une date donnée sous la forme d’un entier. Exemple :
|
Fonctions logiques
| Syntaxe | Description |
|---|---|
IFNULL(expr1, expr2) | Renvoie l’<expr1> si celle-ci n’est pas une valeur nulle, sinon renvoie l’<expr2>.Exemple :
|
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 :
|
ISDATE(string) | Renvoie la valeur vrai si une chaîne donnée est une date valide. Exemple :
|
ISNULL(expression) | Renvoie la valeur True si l’expression ne contient pas de données valides (Null).Exemple :
|
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 :
|
Fonctions d’analytique
| Syntaxe | Description |
|---|---|
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 et renvoie la dernière valeur non nulle. Exemple :
|
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 une valeur nulle si la ligne cible ne peut pas être déterminée. Le paramètre [ Exemple :
Renvoie la valeur SALES de la ligne précédente. |
NTILE(number) | Distribue les lignes d’une partition sélectionnée dans un nombre indiqué de groupes ou de sections. Avec cette fonction, l’ensemble des valeurs (6,9,9,14) distribuées dans 3 sections serait affecté aux sections (1,2,2,3) dans l’ordre croissant. Exemple :
|
RANK() | Renvoie le rang concurrentiel standard de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Exemple :
|
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 :
|
RANK_MODIFIED() | Renvoie le rang concurrentiel modifié de la ligne actuelle de la partition. Un classement identique est attribué à des valeurs identiques. Exemple :
|
RANK_PERCENTILE() | Renvoie le rang centile de la ligne actuelle de la partition. Exemple :
|
ROW_NUMBER() | Renvoie un identifiant de ligne séquentiel unique à chaque ligne. Exemple :
|
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 :
|
RUNNING_SUM(expression) | Renvoie l’addition cumulée d’une expression donnée, de la première ligne de la partition à la ligne actuelle. Exemple :
|
Mots-clés
| Fonction | Description |
|---|---|
AND | Exécute une conjonction logique entre deux expressions Exemple :
|
ASC | Définit l’ordre croissant pour les opérations ORDERBY .Exemple
|
CASE | Trouve la première <value> correspondant à <expr> et renvoie la valeur <return> correspondante.Exemple :
|
DESC | Définit l’ordre décroissant pour les opérations ORDERBY . Exemple :
|
ELSE | Teste une série d’expressions et renvoie la valeur <then> pour la première <expr> positive. Exemple :
|
ELSEIF | Teste une série d’expressions et renvoie la valeur <then> pour la première <expr> positive. Cela équivaut à placer une instruction if à l’intérieur d’une opération ELSE.Exemple :
|
END | Termine une opération introduite par la directive correspondante. Exemple :
|
{ FIXED } | Les expressions de niveau de détail FIXED calculent les valeurs en utilisant les dimensions spécifiées sans faire référence au niveau de détail de la vue. Exemple :
|
IF | Créez une instruction conditionnelle (instruction IF) qui permet de l’exécuter uniquement si une condition est vraie.Exemple :
|
NOT | Exécute une négation logique sur une expression. Exemple :
|
OR | Exécute une disjonction logique sur une expression. Exemple :
|
{ ORDERBY } | Définit l’ordre d’application des fonctions d’analytique. Utilisez l’argument facultatif asc | desc pour préciser l’ordre croissant ou décroissant pour chaque champ. Exemple :
|
{ PARTITION } | Définit le groupe des fonctions d’analytique. ORDERBY doit être à l’intérieur de la partition. Exemple :
|
THEN | Teste une série d’expressions et renvoie la valeur <then> pour la première <expr> positive. Exemple :
|
WHEN | Trouve la première <value> correspondant à <expr> et renvoie la valeur <return> correspondante. Exemple :
|