Guide de référence des fonctions Beast Mode

APPROXIMATE COUNT (DISTINCT)

Renvoie le nombre approximatif de valeurs uniques d'une colonne.

APPROXIMATE_COUNT_DISTINCT(`Customers`)

AVG

Renvoie la valeur moyenne de chaque série d'une colonne.

AVG(`Operating Budget`)

CEILING

Renvoie la valeur la plus élevée de chaque série d'une colonne.

La différence avec la fonction MAX est que la valeur CEILING est arrondie, alors que la valeur MAX n'est pas arrondie.

CEILING(`Operating Budget`)

COUNT

Renvoie le nombre de valeurs de ligne d'une colonne.

COUNT(`Customers`)

COUNT (DISTINCT)

Renvoie le nombre de valeurs uniques d'une colonne.

COUNT(DISTINCT `Customers`)

FLOOR

Renvoie la valeur la plus basse de chaque série d'une colonne numérique.

La différence avec la fonction MIN est que la valeur FLOOR est arrondie, alors que la valeur MIN ne l'est pas.

FLOOR(`Operating Budget`)

MAX

Renvoie la valeur la plus élevée de chaque série d'une colonne numérique.

La différence avec la fonction CEILING est que la valeur CEILING est arrondie, alors que la valeur MAX ne l'est pas.

MAX(`Operating Budget`)

MIN

Renvoie la valeur la plus basse de chaque série d'une colonne numérique.

La différence avec la fonction FLOOR est que la valeur FLOOR est arrondie, alors que la valeur MIN ne l'est pas.

MIN(`Operating Budget`)

STDDEV_POP

Renvoie l'écart type de population pour chaque série d'une colonne numérique.

STDDEV_POP(`Values`)

SUM

Renvoie la somme de chaque série d'une colonne numérique.

SUM(`Values`)

SUM (DISTINCT)

Renvoie la somme des valeurs uniques d'une colonne numérique.

SUM(DISTINCT `Values`)

VAR_POP

Renvoie la variance de population type pour chaque série d'une colonne numérique.

VAR_POP(`Values`)

ABS

Renvoie la valeur absolue de toutes les valeurs d'une colonne numérique.

En d'autres termes, toutes les valeurs négatives deviennent positives et toutes les valeurs positives restent identiques. C'est utile pour voir l'agrégation sans tenir compte des valeurs positives et négatives.

ABS(`budget d'exploitation`)

MOD

Renvoie le reste de chaque valeur d'une colonne numérique divisée par un nombre spécifié (dividende).

MOD(`Values`,2)

POWER

Renvoie chaque valeur d'une colonne numérique élevée à une puissance donnée. Si la colonne contient plusieurs séries, les valeurs sont additionnées pour chaque série.

POWER(`Values`,2)

RAND

Renvoie des valeurs aléatoires entre 0 et 1.

RAND(`Values`)

ROUND

Renvoie les valeurs d'une colonne numérique, arrondies à la décimale spécifiée la plus proche.

Si vous n'incluez pas de nombre de décimales dans la fonction, les valeurs renvoyées sont arrondies au nombre entier le plus proche.

ROUND(`Values`,1)

CASE

À utiliser pour commencer les instructions logiques dans lesquelles la valeur des données sera remplacée dans certaines conditions (quand...alors ou quand...alors, autre). Ces instructions utilisent le format suivant :

CASE `Value` when x then 'resultx' else 'resulty' End

ou
 

CASE when `Value`=x then 'resultx' else 'resulty' End

En d'autres termes, lorsque les données de la colonne « Value » sont égales au nombre x, la valeur resultatx est renvoyée ; sinon, la valeur resultaty est renvoyée. (La valeur renvoyée peut être une chaîne placée entre guillemets simples ou un nombre.)

Pour utiliser plusieurs instructions conditionnelles, servez-vous du format suivant :

CASE when `Value`=x then 1 when `Value`=y then 2 end

Bien que correct, évitez d'utiliser le format inefficace suivant :

CASE  when `Value`=x then 1 else CASE when `Value`=y  then 2 end end

IN Operator

 Dans une clause CASE quand, vous pouvez utiliser l'opérateur IN, qui vous permet de spécifier plusieurs valeurs à évaluer.
`
column_name` IN (value1,value2,...)

C
ASE when `State` in ('NY', 'TX') then 0 else 1 end

LIKE Operator

 Dans une clause CASE when, vous pouvez utiliser l'opérateur LIKE pour rechercher un schéma donné dans une colonne.
`
column_name` LIKE pattern

CASE when `State` like '%TX%' or `State` like '%NY' then 0 else 1 end

 Vous pouvez utiliser les caractères génériques suivants avec l'opérateur LIKE :

• % pour définir la correspondance sur n'importe quel nombre de caractères, y compris les caractères zéro.
  like '%TX%'

• _ pour définir la correspondance sur un seul caractère exactement.
  like '_hn%'

CASE when `Amount`=1 then 10 else 0 End

CASE `Gender`
when 'M' then 'Male'
when 'F' then 'Female'
end

CASE when `Pennies` >= 600 then 'Large'
when `Pennies` <= 300 then 'Small'
else `Pennies`
end

IFNULL

Utilisé dans les instructions logiques où vous spécifiez un remplacement pour les valeurs nulles.

IFNULL(`Values`,0)

NULLIF

Renvoie une valeur nulle si la valeur de la première colonne est égale à celle de la deuxième ; sinon, renvoie la valeur de la première colonne.

NULLIF(`Value 1`,`Value 2`)

CONCAT

Combine les chaînes de plusieurs colonnes contenant des chaînes.

CONCAT(`First Name`,' ',`Last Name`)

LOWER

Convertit les chaînes d'une ou plusieurs colonnes contenant des chaînes en minuscules.

LOWER(`Product Type`)

SUBSTRING

Extrait et renvoie un nombre spécifié de caractères à partir des valeurs d'une colonne de chaînes.

Pour spécifier les caractères à renvoyer, indiquez la position de début et la longueur des caractères. Par exemple, définir la position sur 1 et la longueur sur 3 renvoie les premiers, deuxièmes et troisièmes caractères des valeurs de la colonne.

SUBSTRING(`Employee Name`,1,3)

TRIM

Supprime les interlignes et espaces de fin dans toutes les valeurs des colonnes de chaînes.

TRIM(`Employee Name`)

UPPER

Convertit les chaînes d'une ou plusieurs colonnes de chaînes en majuscules.

UPPER(`Customers`)

ADDDATE

Ajoute des dates ou des valeurs d'horodatage (sous forme d'intervalles) à des valeurs de date dans une colonne de dates.

Pour spécifier les valeurs de date ou d'horodatage afin d'ajouter des valeurs de date dans une colonne, vous pouvez spécifier la colonne, l'intervalle, l'expression et l'unité, au format ADDDATE(`datecolumn`, interval expr unit) où datecolumn est la colonne qui contient la valeur de date, expr l'argument qui contient la valeur de date ou d'horodatage à ajouter, et unit la valeur de chaîne pour le type d'unité de date ou d'horodatage correspondant.

Vous pouvez ajouter le préfixe « - » à l'expression pour soustraire la valeur. Spécifiez la valeur de l'unité (par exemple, seconde, minute, heure, jour, semaine, mois, trimestre, année). (Le mot-clé « intervalle » et les valeurs de type d'unité ne sont pas sensibles à la casse.) Pour obtenir plus d'informations, consultez la rubrique Valeurs de type d'unité dans le Beast Mode.

Par exemple, l'ajout de 12 jours au 4 janvier renvoie 16 janvier.

Similaire à DATE_ADD.

DATEADD(`DateCol`, intervalle 12 jours)

ADDTIME

Ajoute un nombre spécifié de secondes à toutes les valeurs d'une colonne d'heures. Par exemple, l'ajout de 15 secondes à 8h05 renverrait 8h20.

ADDTIME(`Time`,25)

CURDATE

Renvoie la date actuelle.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURRENT_DATE.

CURDATE()

CURTIME

Renvoie l'heure actuelle.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURRENT_TIME.

CURTIME()

CURRENT_DATE

Renvoie la date actuelle.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURDATE.

CURRENT_DATE()

CURRENT_TIME

Renvoie l'heure actuelle.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURTIME.

CURRENT_TIME()

CURRENT_TIMESTAMP

Renvoie la date du jour et l'heure actuelle au format JJ-MM-AAAA HH:MM:SS.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à NOW.

CURRENT_TIMESTAMP()

DATE

Extrait et renvoie les dates des valeurs d'horodatage.

DATE(`DateCol`)

DATEDIFF

Renvoie le nombre de jours entre deux dates des valeurs d'horodatage.

DATEDIFF(CURRENT_DATE(), `lastmoddate`)

DATE_ADD

Ajoute des dates ou des valeurs d'horodatage (sous forme d'intervalles) à des valeurs de date dans une colonne de dates.

Pour spécifier les valeurs de date ou d'horodatage afin d'ajouter des valeurs de date dans une colonne, vous pouvez spécifier la colonne, l'intervalle, l'expression et l'unité, au format DATE_ADD(`datecolumn`, interval exprunit) où datecolumn est la colonne qui contient la valeur de date, expr l'argument qui contient la valeur de date ou d'horodatage à ajouter, et unit la valeur de chaîne pour le type d'unité de date ou d'horodatage correspondant.

Vous pouvez ajouter le préfixe « - » à l'expression pour soustraire la valeur. Spécifiez la valeur de l'unité (par exemple, seconde, minute, heure, jour, semaine, mois, trimestre, année). (Le mot-clé « intervalle » et les valeurs de type d'unité ne sont pas sensibles à la casse.) Pour obtenir plus d'informations, consultez la rubrique Valeurs de type d'unité dans le Beast Mode.

Par exemple, l'ajout de 12 jours au 4 janvier renvoie 16 janvier.

Similaire à ADDDATE.

DATE_ADD(`DateCol`, interval 12 day)

DATE_FORMAT

Formate les dates d'une colonne date/heure avec un format spécifique.

Pour spécifier le format à utiliser pour une colonne de date ou heure, spécifiez la colonne et la chaîne de date ou heure au format DATE_FORMAT(`datecolumn`,'format') où datecolumn est la colonne qui contient la valeur de date et format, la chaîne contenant les caractères de spécificateur de format à utiliser pour mettre en forme la valeur de date.

Le caractère « % » est requis avant les caractères de spécificateur de format.

Par exemple, avec DATE_FORMAT(`MyDate`,'%Y-%m-%d %h:%i %p'), la date de la colonne de date MyDate utilise le format suivant : 2013-04-17 10:10 AM.

Pour obtenir plus d'informations sur les caractères de spécificateur de format, consultez la rubrique Caractères de spécificateur de format de date dans Beast Mode.

Similaire à TIME_FORMAT.

DATE_FORMAT(`DateCol`,'%y')
DATE_FORMAT(`DateCol`,'%m/%d')
DATE_FORMAT(NOW(),'%d %b %Y %T')
DATE_FORMAT(STR_TO_DATE(`DateCol`, '%m,%d,%Y'), '%m/%d/%Y')
ADDDATE(DATE_FORMAT(`DateCol`, '%Y-%m-%d'), interval 12 day)
PERIOD_DIFF(DATE_FORMAT(CURDATE(), '%Y%m'), DATE_FORMAT(`DateCol`, '%Y%m'))

DATE_SUB

Soustrait des valeurs de date ou d'horodatage (sous forme d'intervalles) aux valeurs de date d'une colonne de dates.

Pour spécifier les valeurs de date ou d'horodatage afin de soustraire des valeurs de date dans une colonne, vous pouvez spécifier la colonne, l'intervalle, l'expression et l'unité, au format DATE_SUB(`datecolumn`, interval exprunit) où datecolumn est la colonne qui contient la valeur de date, expr l'argument qui contient la valeur de date ou d'horodatage à soustraire, et unit la valeur de chaîne pour le type d'unité de date ou d'horodatage correspondant.

Vous pouvez ajouter le préfixe « - » à l'expression pour ajouter la valeur. Spécifiez la valeur de l'unité (par exemple, seconde, minute, heure, jour, semaine, mois, trimestre, année). (Le mot-clé « intervalle » et les valeurs de type d'unité ne sont pas sensibles à la casse.) Pour obtenir plus d'informations, consultez la rubrique Valeurs de type d'unité dans le Beast Mode.

Par exemple, soustraire 12 jours du 24 janvier renvoie 12 janvier.

Similaire à SUBDATE.

SUB_DATE(`DateCol`, intervalle 12 jours)

DAY

Renvoie le chiffre du jour du mois pour toutes les valeurs d'une colonne de date/heure.

Similaire à DAYOFMONTH.

DAY(`DateCol`)

DAYNAME

Renvoie le nom du jour de la semaine pour toutes les valeurs d'une colonne date/heure.

DAYNAME(`DateCol`)

DAYOFMONTH

Renvoie le chiffre du jour du mois pour toutes les valeurs d'une colonne de date/heure.

Similaire à DAY.

DAYOFMONTH(`DateCol`)

DAYOFWEEK

Renvoie le numéro du jour de la semaine pour toutes les valeurs d'une colonne date/heure (ex. : « 2 » pour « lundi »).

Similaire à WEEKDAY. La différence avec la fonction WEEKDAY est que la fonction DAYOFWEEK est basée sur 1 et commence le dimanche, alors que WEEKDAY est basée sur 0 et commence le lundi.

DAYOFWEEK(`DateCol`)

DAYOFYEAR

Renvoie le numéro du jour de l'année pour toutes les valeurs d'une colonne date/heure (ex. : « 226 » pour le 226e jour de l'année).

DAYOFYEAR(`DateCol`)

FROM_DAYS

Convertit les numéros de jour en dates.

FROM_DAYS(`DateCol`)

Renvoie une valeur d'horodatage UNIX à partir d'une colonne de date/heure UNIX à l'aide du format spécifié.

Pour obtenir plus d'informations sur les caractères de spécificateur de format, consultez la rubrique Caractères de spécificateur de format de date dans Beast Mode.

FROM_UNIXTIME(`UnixDateCol`,'%Y %d %m %h:%i:%s %x')

HOUR

Renvoie l'heure, sans les minutes, pour toutes les valeurs d'une colonne date/heure (ex. : l'heure « 3:36 » renvoie « 3 »).

HOUR(`Time`)

LAST_DAY

Agrège les valeurs de chaque mois dans une colonne date/heure et renvoie chaque agrégation sous forme du dernier jour de chaque mois.

Par exemple, si la colonne de date/heure contient les valeurs « 15 », « 16 » et « 17 » pour le mois de janvier, seule la dernière date de janvier s'affiche, avec la valeur combinée de 48.

LAST_DAY(`DateCol`)

MINUTE

Renvoie la valeur de chaque minute dans une colonne Heure.

S'il y a plusieurs instances d'une certaine minute dans la colonne, les valeurs de ces minutes sont regroupées.

MINUTE(`Time`)

MONTH

Renvoie le numéro du mois (ex. : « 9 » pour septembre) pour toutes les valeurs d'une colonne date/heure.

MONTH(`DateCol`)

MONTHNAME

Renvoie le nom du mois (ex. : « Septembre » au lieu de « 9 ») pour toutes les valeurs d'une colonne d'horodatage.

MONTHNAME(`DateCol`)

NOW

Renvoie la date du jour et l'heure actuelle au format JJ-MM-AAAA HH:MM:SS.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURRENT_TIMESTAMP.

NOW()

PERIOD_ADD

Ajoute le nombre spécifié de mois à toutes les valeurs d'une colonne de dates. Pour que cela fonctionne, les valeurs des dates doivent être des mois au format MMAAAA.

PERIOD_ADD(`Month`,6)

PERIOD_DIFF

Renvoie le nombre de mois entre les mois de deux colonnes de dates.

Pour que cela fonctionne, les valeurs des dates doivent être des mois au format MMAAAA. Par exemple, lorsqu'une colonne contient la valeur de date 032008 et l'autre la valeur 092008, cette fonction renvoie 6.

PERIOD_DIFF(201309,201301)
PERIOD_DIFF(`Month 1`, `Month 2`)
PERIOD_DIFF(DATE_FORMAT(CURDATE(), '%Y%m'), DATE_FORMAT(`DateCol`, '%Y%m'))

QUARTER

Regroupe les données des valeurs de date en trimestres dans une année.

QUARTER(`DateCol`)

SECOND

Renvoie la valeur de chaque seconde dans une colonne Heure. S'il y a plusieurs instances d'une certaine seconde dans la colonne, les valeurs de ces secondes sont regroupées.

SECOND(`Time`)

SEC_TO_TIME

Convertit les secondes en heures, minutes et secondes. Par exemple, 3489 renverrait 00:58:09.

SEC_TO_TIME(`Seconds`)

STR_TO_DATE

Convertit les chaînes (que Domo ne reconnaît pas comme des dates) d'une ou plusieurs colonnes de chaîne en valeurs date et heure. Vous spécifiez la ou les colonnes et le format de date actuellement utilisé dans ces colonnes.

Par défaut, les valeurs d'horodatage sont renvoyées au format %m-%d-%Y. Pour modifier le format du résultat, placez votre calcul STR_TO_DATE dans un calcul DATE_FORMAT spécifiant les caractères de spécificateur de format de date requis.

Pour obtenir plus d'informations sur les caractères de spécificateur de format, consultez la rubrique Caractères de spécificateur de format de date dans Beast Mode.

STR_TO_DATE(`DateCol`,'%m,%d,%Y')
DATE_FORMAT(STR_TO_DATE(`DateCol`, '%m,%d,%Y'), '%m/%d/%Y')

SUBDATE

Soustrait des valeurs de date ou d'horodatage (sous forme d'intervalles) aux valeurs de date d'une colonne de dates.

Pour spécifier les valeurs de date ou d'horodatage afin de soustraire des valeurs de date dans une colonne, vous pouvez spécifier la colonne, l'intervalle, l'expression et l'unité, au format SUBDATE(`datecolumn`, interval exprunit) où datecolumn est la colonne qui contient la valeur de date, expr l'argument qui contient la valeur de date ou d'horodatage à soustraire, et unit la valeur de chaîne pour le type d'unité de date ou d'horodatage correspondant.

Vous pouvez ajouter le préfixe « - » à l'expression pour ajouter la valeur. Spécifiez la valeur de l'unité (par exemple, seconde, minute, heure, jour, semaine, mois, trimestre, année). (Le mot-clé « intervalle » et les valeurs de type d'unité ne sont pas sensibles à la casse.) Pour obtenir plus d'informations, consultez la rubrique Valeurs de type d'unité dans le Beast Mode.

Par exemple, soustraire 12 jours du 24 janvier renvoie 12 janvier. Similaire à DATE_SUB.

SUBDATE(`DateCol`, intervalle 12 jours)

SUBTIME

Soustrait un nombre spécifié de secondes de toutes les valeurs d'une colonne d'heures.

Par exemple, soustraire 30 secondes à 8h05m45s renverrait 8h05m15s.

SUBTIME(`Time`,15)

SYSDATE

Renvoie la date du jour et l'heure actuelle au format JJ-MM-AAAA HH:MM:SS, comme dans 03-04-2014H19h25m29s.

Aucun nom de colonne n'est spécifié dans cette fonction.

Similaire à CURRENT_DATE et CURRENT_TIME.

SYSDATE()

TIME

Extrait les heures des valeurs d'horodatage.

TIME(`DateCol`)

TIMEDIFF

Renvoie la différence entre les valeurs de deux colonnes date/heure, exprimée sous forme d'heure.

TIMEDIFF(`Time 1`,`Time 2`)

TIMESTAMP

Renvoie les valeurs d'une colonne de dates sous forme de valeurs Date et heure.

TIMESTAMP(`DateCol`)

TIME_FORMAT

Formate les heures d'une colonne Date et heure avec un format spécifique.

Pour spécifier le format à utiliser pour les valeurs d'une colonne d'heure, spécifiez la colonne et la chaîne d'heure au format TIME_FORMAT(`datetimecolumn`,'format'), où datetimecolumn est la colonne qui contient la valeur d'heure et où format est la chaîne qui contient les caractères de spécificateur de format à utiliser pour mettre en forme la valeur.

Le caractère « % » est requis avant les caractères de spécificateur de format.

Par exemple, avec TIME_FORMAT(`Date`,'%h:%i:%s'), la date de la colonne d'heure transformée utilise le format suivant : 12h20m12s

Pour obtenir plus d'informations sur les caractères de spécificateur de format, consultez la rubrique Quels caractères de spécificateur de format de date puis-je utiliser dans le Beast Mode ?.

Similaire à DATE_FORMAT.

TIME_FORMAT(`Date`,'%h:%i:%s')
TIME_FORMAT(NOW(),'%h:%i:%s')

TIME_TO_SEC

Renvoie un nombre de secondes écoulées pour toutes les valeurs d'une colonne date/heure.

TIME_TO_SEC(`DateCol`)

TO_DAYS

Renvoie le nombre de jours depuis l'an 0 pour toutes les valeurs d'une colonne date/heure. Par exemple, la date « 06-01-2010 » devient « 734143 » puisque 734 143 jours se sont écoulés entre cette date et le 1er janvier de l'année 0.

TO_DAYS(`DateCol`)

WEEKDAY

Renvoie le numéro du jour de la semaine pour toutes les valeurs d'une colonne date/heure (ex. : « 0 » pour « Lundi »).

Similaire à DAYOFWEEK. La différence avec la fonction DAYOFWEEK est que la fonction WEEKDAY est basée sur 0 et commence le lundi, alors que DAYOFWEEK est basée sur 1 et commence le dimanche.

WEEKDAY(`DateCol`)

YEAR

Renvoie l'année pour toutes les valeurs d'une colonne date/heure.

YEAR(`DateCol`)

YEARWEEK

Renvoie l'année et le numéro de la semaine pour toutes les valeurs d'une colonne date/heure au format YYYYWW.

Par exemple, renvoie 201232 pour la 32e semaine de l'année 2012.

YEARWEEK(`DateCol`)