Vous êtes ici :
Fonctions de dimension calculée
Vous pouvez utiliser des fonctions lorsque vous créez des dimensions calculées.
Éditions requises
| Disponible avec : Rapports Intelligence avancés |
Les fonctions sont divisées en catégories :
- Fonctions numériques
- Fonctions de texte
- Fonctions de date
- Fonctions d'agrégation
- Fonctions logiques
- Conversion du type
- Fonctions de contenu
Les tableaux suivants récapitulent les fonctions disponibles pour les dimensions calculées.
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| ABS | ABS(number) | Renvoie la valeur absolue d'un nombre. |
| CEILING | CEILING(number, significance) | Arrondit le nombre vers le haut, en s’éloignant de zéro au multiple de signification le plus proche. |
| FLOOR | FLOOR(number, significance) | Arrondit le nombre vers le bas, en direction de zéro au multiple de signfication le plus proche. |
| RAND | RAND() | Obtient un nombre aléatoire compris entre 0 et 1. |
| ROUND | ROUND(number) | Arrondit un nombre à l’entier le plus proche. |
| ROUND | ROUND(number, num_digits) | Arrondit un nombre à un nombre de chiffres spécifié. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| CHAR | CHAR(number) | Renvoie un caractère spécifié par un nombre. |
| COALESCE | COALESCE([value1, value2,...]) | Renvoie la première valeur de la liste qui n'est pas vide. |
| CODE | CODE(text) | Renvoie un code numérique pour le premier caractère d'une chaîne de texte. |
| COUNT_CHAR | COUNT_CHAR(text, charToCount) | Calcule le nombre de fois où un caractère spécifique apparaît dans un texte. |
| EXTRACT | EXTRACT(text, delimiter, position) | Extrait du texte donné la sous-chaîne à la position donnée, après la séparation par le délimiteur donné. Par exemple, EXTRACT(‘a,b,c’,’_’,1) renvoie ‘b’. |
| FIND | FIND(findText, withinText) | Renvoie la position de départ de findText withinText. Renvoie 1 si withinText ne contient pas findText. |
| FUZZYMATCH | FUZZYMATCH(valueToMatch, array, threshold) | Recherche une chaîne dans un tableau de valeurs qui peuvent potentiellement correspondre à l'aide d'algorithmes duplication-détection qui calculent la similarité de deux flux de données. Renvoie la chaîne correspondante du tableau si une correspondance existe ou, si aucune correspondance n'est trouvée, renvoie une chaîne vide. Par exemple, FUZZYMATCH("ABC Company",{"ABC Company Inc","Apple Inc","IBM Company"},0.8) renvoie "ABC Company Inc". Le paramètre de seuil doit être une valeur comprise entre 0 et 1. Un seuil de 1 indique une correspondance exacte. |
| GET_EXCHANGE_RATE | GET_EXCHANGE_RATE(date, fromISO, toISO) | Obtient le taux de change des devises et de la date données. La variable de ‘date’ de la formule peut être un champ de date mappé ou une fonction de date Par exemple :
où [Day] est un champ de date mappé
où DATE('YYYY','MM','DD') est une fonction de date.
où YESTERDAY() est une fonction de date. |
| INDEXOF | INDEXOF(array, findText) | Recherche le tableau de l’élément spécifié,et renvoie sa position. Renvoie -1 si l'élément n'est pas trouvé. Si l'élément est présent plusieurs fois, la fonction INDEXOF renvoie la position de la première occurrence. Par exemple, INDEXOF(csv['row'], 'Campaign ID') == 0 renvoie la valeur true si 'Campaign ID’ est trouvé dans la première cellule. Remarque : Le premier élément a la position 0, le deuxième élément a la position 1, et ainsi de suite. |
| ISEMPTY | ISEMPTY(value) | Renvoie si la valeur est vide ou non. |
| LEFT | LEFT(text, numOfChars) | Renvoie le nombre de caractères requis à partir de la gauche. |
| LEN | LEN(text) | Renvoie le nombre de caractères du texte donné |
| LOWER | LOWER(text) | Convertit toutes les lettres majuscules en une chaîne de lettres minuscules. |
| MATCH | MATCH(valueToMatch, array) | Recherche un élément spécifié dans un tableau de valeurs, puis renvoie un résultat booléen. Par exemple, renvoie true car la valeur '1’ existe dans le tableau. |
| PROPER | PROPER(text) | Met en majuscule la première lettre d’une chaîne de texte ainsi que toute autre lettre du texte qui suit tout caractère autre qu’une lettre. Convertit toutes les autres lettres en minuscules. |
| REPLACE | REPLACE(SourceStr, pattern, targetStr) | Remplace toutes les correspondances d'un modèle (une expression regex) dans sourceStr par targetStr. Par exemple, REPLACE('All-The-Best', '-', ' ') renvoie 'All The Best’. Autre exemple, REPLACE('Let It Be','\\s','-') renvoie 'Let-It-Be'. |
| RIGHT | RIGHT(text, numOfChars) | Renvoie le nombre de caractères requis à partir de la droite. |
| SELECT | SELECT(sourceStr, pattern) | Sélectionne la première correspondance du modèle (une expression regex) dans sourceStr. Par exemple, SELECT('Hello B wow E Goodbye', 'B(.*?)E') renvoie 'B wow E'. |
| SEMTIMEN | SENTIMEN(text) | Extrait un sentiment positif, neutre ou négatif du texte donné. |
| SPLIT | SPLIT(text, delimiter) | Sépare une chaîne de texte en tableau en utilisant un caractère délimiteur. Il renvoie un tableau unidimensionnel base zéro qui contient les parties de la chaîne de texte d'origine. Par exemple, SPLIT('a,b,c', ',') renvoie un tableau avec trois éléments. |
| SUBSTITUTE | SUBSTITUTE(text,oldText,newText) | Remplace oldText par newText dans une chaîne de texte. Utilisez SUBSTITUTE pour remplacer un texte spécifique dans une chaîne de texte. |
| SUBSTRING | SUBSTRING(text,beginIndex,endIndex) | Renvoie la sous-chaîne du texte qui commence par beginIndex (inclusif) et se termine par endIndex (exclusif). |
| TRIM | TRIM(text) | Retire tous les espaces du texte, sauf les espaces uniques entre les mots. |
| UPPER | UPPER(text) | Convertit toutes les lettres minuscules d’une chaîne de texte en majuscules. |
| URL_DECODE | URL_DECODE(text) | Décode une chaîne application/x-www-form-urlencoded en utilisant un système de codage UTF-8. |
| URL_ENCODE | URL_ENCODE(text) | Traduit un texte en un format application/x-www-form-urlencoded en utilisant un système de codage UTF-8. |
| VALUE_FROM_JSON | VALUE_FROM_JSON(JSON string, key) | Renvoie la valeur d'une clé donnée dans une chaîne JSON. Si la clé n’existe pas ou si le fichier JSON est vide, une chaîne vide est renvoyée. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| DATE | DATE(year, month) | Renvoie le premier jour du mois donné dans la année spécifiée. |
| DATE | DATE(year, month, day) | Renvoie la date représentant les arguments donnés. |
| DATEADD | DATEADD(interval, number, date) | Renvoie la date après l'ajout d'un intervalle de dates ou de temps spécifique. L'intervalle doit être 'yyyy' (année), 'q' (trimestre), 'm' (mois), 'd' (jour), 'ww' (semaine), 'h' (heure), 'n' (minute), ou 's' (seconde). |
| DATEDIFF | DATEDIFF(interval,startDate,endDate | Renvoie le nombre d'unités de temps spécifiées par l’intervalle entre la date de début (startDate) et la date de fin (endDate). Les arguments startDate et endDate doivent être des objets de date ou des chaînes de date dans un format standard. L'intervalle doit être 'yyyy' (année), 'q' (trimestre), 'm' (mois), 'd' (jour), 'ww' (semaine), 'h' (heure), 'n' (minute), ou 's' (seconde). |
| DAYPRECISION | Dayprecision (date) | Renvoie la date donnée avec une précision sur le jour, ce qui signifie que les champs heures, minutes et secondes sont tous définis sur 0. Par exemple, la date '12-Jun-2012 16:34’ est convertie en '12-Jun-2012 00:00’. |
| DAYSBETWEEN | DAYSBETWEEN(startDate, endDate) | Renvoie le nombre de jours entre la date de début (startDate) et la date de fin (endDate) données. Les arguments doivent être des objets de date ou des chaînes de date dans un format standard. |
| DAYSINMONTH | DAYSINMONTH(date) | Renvoie le nombre de jours dans un mois spécifié. |
| NETWORKDAYS | NETWORKDAYS(startDate, endDate) | Renvoie le nombre de journées de travail entre deux dates, weekends exclus. Les arguments doivent être des objets de date ou des chaînes de date dans un format standard. |
| NOW | NOW() | Renvoie la date et l'heure actuelles du système. |
| SETHOUR | SETHOUR(date, hour) | Renvoie la date donnée définie avec les heures données, l'heure étant une valeur numérique comprise de 0 et 23. |
| TODAY | TODAY() | Renvoie la date actuelle du système. |
| TOSECONDS | TOSECONDS(duration) | Renvoie le nombre de secondes représenté par la chaîne de durée donnée au format HH:mm:ss/HH:mm:ss.SSS. |
| YESTERDAY | YESTERDAY() | Renvoie la date système du jour précédent. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| GROUPCONCAT | GROUPCONCAT(groupedDimension, keyDimension, separator) | Concatène les valeurs de groupedDimension par keyDimension, avec la chaîne de séparateur entre les deux valeurs regroupées. Ce processus est effectué une seule fois, c’est-à-dire que la même valeur répétée n'est pas concaténée deux fois. Par exemple, GROUPCONCAT({Media Buy Name}, {Campaign Name}, ',' ) entraîne la concaténation de tous les noms d’achat média (sans répétition) pour chaque campagne. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| ET | AND(condition1, condition2) | ET logique, vérifie que les deux conditions sont vraies. |
| IF | IF(condition,resultifTrue,resultifFalse) | Renvoie le deuxième argument, si le premier argument est true, et le troisième argument autrement. |
| IFERROR | IFERROR(someExpression, number) | Renvoie someExpression s'il s'agit d'un nombre valide, ou un nombre autrement. |
| NOT | NOT(condition) | NOT logique, inverse la logique de son argument, true devient false et vice-versa. |
| OU | OR(condition) | OR logique, vérifie si l'une des conditions est true. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| COMPRESS | COMPRESS(value1) | Compresse une chaîne en utilisant gzip, et la renvoie en base64. |
| DECODE_BASE64 | DECODE_BASE64(value1) | Décode une chaîne de base64. |
| DOUBLE | DOUBLE(value1) | Convertit une chaîne en un double. |
| ENCODE_BASE64 | ENCODE_BASE64(value1) | Code une chaîne en base64. |
| FORMATDATE | FORMATDATE(date, pattern) | Renvoie la représentation de la chaîne de la date donnée selon le modèle fourni. Par exemple, 'yyyy-MM-dd' --> 2014-02-25, 'dd MMM-yyyy' --> 25 Feb-2014, etc. |
| FORMATDATE_DEFAULT | FORMATDATE_DEFAULT(date) | Renvoie la représentation de la chaîne Rapports Intelligence par défaut (yyyy-MM-dd HH:mm:ss.S) de la chaîne de la date donnée. |
| MD5 | MD5(stringToHash) | Renvoie un hachage MD5 de la chaîne donnée. |
| NUMBER | NUMBER(value1) | Convertit une chaîne en un nombre |
| PARSEDATE | PARSEDATE(dateString, pattern) | Renvoie l'objet de date spécifié par la dateString donnée en utilisant le modèle donné. Par exemple, '2014-02-25' ---> 'yyyy-MM-dd', '25 Feb-2014' ---> 'dd MMM-yyyy', etc. |
| SHA256 | SHA256(stringToHash) | Renvoie un hachage SHA256 de la chaîne donnée. |
| STRIP_HTML | STRIP_HTML(value1) | Efface HTML dans une chaîne. |
| UNCOMPRESS | UNCOMPRESS(value1) | Décompresse une chaîne base64 en utilisant gzip. |
| Nom de la fonction | Syntaxe | Description |
|---|---|---|
| CONTEXT_DIMENSION_CONTAINS | CONTEXT_DIMENSIONS_CONTAIN(dimension) | Renvoie une valeur 'true' si la dimension donnée est incluse dans la requête. |
| CONTEXT_DIMENSION_EQUALS | CONTEXT_DIMENSIONS_EQUALS(dimension) | Renvoie une valeur 'true’ si les dimensions données sont les dimensions du contexte exactes. Saisissez toutes les dimensions pertinentes, mais l’ordre d’affichage n’est pas important. |
| FilterEndDate | FilterEndDate() | Renvoie la date de fin du filtre de requête. |
| FilterStartDate | FilterStartDate() | Renvoie la date de début du filtre de requête. |
| GET_ENV | GET_ENV(variableName) | Renvoie la valeur de la variable d'environnement donné. Les valeurs possibles pour variableName sont : WORKSPACE_ID |
| QUERY_DIMENSIONS_CONTAIN | QUERY_DIMENSIONS_CONTAIN(dimension) | Renvoie une valeur 'true’ si la dimension donnée est l’une des dimensions de requête. |
| QUERY_DIMENSIONS_EQUAL | QUERY_DIMENSIONS_EQUAL([dimensions]) | Renvoie une valeur 'true’ si les dimensions données sont les dimensions de requête exactes. Saisissez toutes les dimensions pertinentes, mais l’ordre d’affichage n’est pas important. |
Cet article a-t-il résolu votre problème ?
Dites-nous ce que nous pouvons améliorer !
