Les fonctions de date et heure de Qlik Sense sont destinées à transformer et à convertir les valeurs de date et heure. Elles s'utilisent toutes aussi bien dans le script de chargement de données que dans les expressions de graphique.
Ces fonctions sont basées sur un numéro de série date-heure équivalant au nombre de jours qui se sont écoulés depuis le 30 décembre 1899. La valeur entière représente le jour tandis que la valeur fractionnaire correspond à l'heure du jour.
Qlik Sense utilise la valeur numérique du paramètre. De ce fait, un nombre est également valide en tant que paramètre lorsqu'il n'est pas formaté sous forme de date ou d'heure. Si le paramètre ne correspond pas à une valeur numérique, par exemple s'il s'agit d'une chaîne, Qlik Sense tente d'interpréter la chaîne en fonction des variables d'environnement de date et heure.
Si le format de l'heure utilisé dans le paramètre ne correspond pas à celui défini dans les variables d'environnement, Qlik Sense n'est pas en mesure d'effectuer une interprétation correcte. Pour résoudre ce problème, modifiez les paramètres ou utilisez une fonction d'interprétation.
Dans les exemples fournis pour chaque fonction, nous partons du principe que les formats d'heure et de date par défaut hh:mm:ss et YYYY-MM-DD (ISO 8601) sont utilisés.
Lors du traitement d'un horodatage à l'aide d'une fonction de date ou d'heure, Qlik Sense ignore tous les paramètres d'heure d'été, à moins que la fonction de date ou d'heure n'inclut une position géographique.
Par exemple, ConvertToLocalTime( filetime('Time.qvd'), 'Paris') utiliserait les paramètres d'heure d'été, contrairement à ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00').
Pour afficher une description succincte et la syntaxe d'une fonction, utilisez le menu déroulant de chaque fonction. Pour plus d'informations, cliquez sur le nom de la fonction dans la description de la syntaxe.
Expressions entières de temps
Cette fonction renvoie un entier représentant la seconde au cours de laquelle la fraction de l'expression est interprétée comme une heure selon l'interprétation standard des nombres.
second(expression)
Cette fonction renvoie un entier représentant la minute au cours de laquelle la fraction de l'expression est interprétée comme une heure selon l'interprétation standard des nombres.
minute(expression)
Cette fonction renvoie un entier représentant l'heure au cours de laquelle la fraction de l'expression est interprétée comme une heure selon l'interprétation standard des nombres.
hour(expression)
Cette fonction renvoie un entier représentant le jour au cours duquel la fraction de l'expression est interprétée comme une date selon l'interprétation standard des nombres.
day(expression)
Cette fonction renvoie un entier représentant le numéro de la semaine selon la norme ISO 8601. Le numéro de la semaine est calculé à partir de l'interprétation de date de l'expression, conformément à l'interprétation standard des nombres.
week(expression)
Cette fonction renvoie une valeur double : un nom de mois tel que défini dans la variable d'environnement MonthNames et un entier compris entre 1 et 12. Le mois est calculé à partir de l'interprétation de date de l'expression, conformément à l'interprétation standard des nombres.
month(expression)
Cette fonction renvoie un entier représentant l'année au cours de laquelle l'expression est interprétée comme une date selon l'interprétation standard des nombres.
year(expression)
Cette fonction renvoie l'année à laquelle le numéro de semaine appartient selon la norme ISO 8601. Le numéro de la semaine est compris entre 1 et environ 52.
weekyear(expression)
Cette fonction renvoie une valeur double avec :
- Un nom de jour tel que défini dans la variable d'environnement DayNames.
- Un entier compris entre 0 et 6 correspondant au jour nominal de la semaine (0-6).
weekday(date)
Fonctions d'horodatage
Cette fonction renvoie un horodatage de l'heure actuelle. La fonction renvoie des valeurs au format de variable système TimeStamp. La valeur timer_mode par défaut est 1.
now([ timer_mode])
Cette fonction renvoie la date actuelle. La fonction renvoie des valeurs au format de variable système DateFormat.
today([timer_mode])
Cette fonction renvoie un horodatage de l'heure actuelle pour un fuseau horaire donné.
localtime([timezone [, ignoreDST ]])
Fonctions de calcul de date et d'heure make
Cette fonction renvoie une date calculée à partir de l'année YYYY, du mois MM et du jour DD.
makedate(YYYY [ , MM [ , DD ] ])
Cette fonction renvoie une date calculée à partir de l'année YYYY, de la semaine WW et du jour de la semaine D.
makeweekdate(YYYY [ , WW [ , D ] ])
Cette fonction renvoie une heure calculée à partir de l'heure hh, de la minute mm et de la seconde ss.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
Autres fonctions de date
Cette fonction renvoie la date correspondant à n mois après la date startdate ou, si n est une valeur négative, la date correspondant à n mois avant la date startdate.
addmonths(startdate, n , [ , mode])
Cette fonction renvoie la date correspondant à n années après la date startdate ou, si n est une valeur négative, la date correspondant à n années avant la date startdate.
addyears(startdate, n)
Cette fonction permet de déterminer si l'horodatage tombe dans l'année de la date à laquelle le script a été chargé pour la dernière fois et renvoie True si c'est le cas ou False si ce n'est pas le cas.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Fonctions de fuseau horaire
Cette fonction renvoie le nom du fuseau horaire actuel, tel qu'il est défini dans Windows.
timezone( )
Cette fonction renvoie l'heure Greenwich Mean Time actuelle, indiquée par les paramètres régionaux.
GMT( )
Renvoie la valeur actuelle de l'argument Coordinated Universal Time.
UTC( )
Renvoie le réglage actif de l'heure d'été, tel qu'il est défini dans Windows.
Convertit un horodatage UTC ou GMT en heure locale sous la forme d'une valeur double. Il peut s'agir de n'importe quelle ville, n'importe quelle région ou n'importe quel fuseau horaire dans le monde.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Fonctions de réglage de l'heure
Cette fonction utilise comme données d'entrée un horodatage timestamp et une année year , puis elle met à jour l'horodatage timestamp avec l'année year spécifiée dans les données d'entrée.
setdateyear (timestamp, year)
Cette fonction utilise comme données d'entrée un horodatage timestamp, un mois month et une année year , puis elle met à jour l'horodatage timestamp avec l'année year et le mois month spécifiés dans les données d'entrée.
setdateyearmonth (timestamp, year, month)
Fonctions d'inclusion in...
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans l'année comprenant l'argument base_date.
inyear(date, basedate , shift [, first_month_of_year = 1])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie de l'année comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.
inyeartodate (date, basedate , shift [, first_month_of_year = 1])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans le trimestre comprenant l'argument base_date.
inquarter (date, basedate , shift [, first_month_of_year = 1])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie du trimestre comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans le mois comprenant l'argument base_date.
inmonth(date, basedate , shift)
Renvoie la valeur True si l'argument date se trouve dans la partie du mois comprenant l'argument basedate jusqu'à la dernière milliseconde spécifiée dans basedate.
inmonthtodate (date, basedate , shift)
Cette fonction permet de déterminer si un horodatage tombe pendant la même période (mois, période de deux mois, trimestre, période de quatre mois ou semestre) que la date de référence. Il est également possible de déterminer si l'horodatage se situe dans une période passée ou future.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Cette fonction permet de déterminer si un horodatage tombe dans la partie d'une période (mois, période de deux mois, trimestre, période de quatre mois ou semestre) jusqu'à la dernière milliseconde incluse spécifiée dans base_date. Il est également possible de déterminer si l'horodatage se situe dans une période passée ou future.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la semaine comprenant l'argument base_date.
inweek(date, basedate , shift [, weekstart])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie de la semaine comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.
inweektodate (date, basedate , shift [, weekstart])
Cette fonction détermine si l'argument timestamp tombe pendant la semaine lunaire comprenant l'argument base_date. Dans Qlik Sense, les semaines lunaires sont définies en comptant le 1er janvier comme le premier jour de la semaine. À l'exception de la dernière semaine de l'année, chaque semaine contiendra exactement sept jours.
inlunarweek (date, basedate , shift [, weekstart])
Cette fonction détermine si l'argument timestamp se trouve dans la partie de la semaine lunaire jusqu'à la dernière milliseconde spécifiée dans base_date. Dans Qlik Sense, les semaines lunaires sont définies en comptant le 1er janvier comme le premier jour de la semaine et, à l'exception de la dernière semaine de l'année, elles contiendront exactement sept jours.
inlunarweektodate (date, basedate , shift [, weekstart])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans le jour comprenant l'argument base_timestamp.
inday(timestamp, basetimestamp , shift [, daystart])
Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie du jour comprenant l'argument base_timestamp jusqu'à la milliseconde exacte spécifiée dans base_timestamp.
indaytotime(timestamp, basetimestamp , shift [, daystart])
Fonctions de début... et de fin
Cette fonction renvoie un horodatage correspondant au début du premier jour de l'année contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
yearstart( date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du dernier jour de l'année contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
yearend( date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une année composée de quatre chiffres comme valeur d'affichage avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour de l'année contenant l'argument date.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du trimestre contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du trimestre contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur d'affichage présentant les mois du trimestre (formatés selon la variable de script MonthNames) et l'année avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour du trimestre.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du premier jour du mois contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
monthstart(date [, shift = 0])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du dernier jour du mois contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
monthend(date [, shift = 0])
Cette fonction renvoie une valeur d'affichage présentant le mois (formaté selon la variable de script MonthNames) et l'année avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour du mois.
monthname(date [, shift = 0])
Cette fonction renvoie une valeur correspondant à l'horodatage de la première milliseconde du mois, de la période de deux mois, du trimestre, de la période de quatre mois ou du semestre contenant une date de référence. Il est également possible de rechercher l'horodatage d'une période passée ou future.Le format de sortie par défaut correspond au format de date DateFormat défini dans le script.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du mois, de la période de deux mois, du trimestre, de la période de quatre mois ou du semestre contenant une date de référence. Il est également possible de rechercher l'horodatage d'une période passée ou future.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur d'affichage représentant la plage des mois de la période (formatée d'après la variable de script MonthNames) de même que l'année. La valeur numérique sous-jacente correspond à un horodatage de la première milliseconde du mois, de la période de deux mois, du trimestre, de la période de quatre mois ou du semestre contenant une date de référence.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du premier jour de la semaine calendaire contenant l'argument date. Le format de sortie par défaut correspond au format de date DateFormat défini dans le script.
weekstart(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du dernier jour (dimanche) de la semaine calendaire contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.
weekend(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur affichant l'année et le numéro de la semaine avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour de la semaine contenant l'argument date.
weekname(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du premier jour de la semaine lunaire contenant l'argument date. Dans Qlik Sense, les semaines lunaires sont définies en comptant le 1er janvier comme le premier jour de la semaine et, à l'exception de la dernière semaine de l'année, elles contiendront exactement sept jours.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du dernier jour de la semaine lunaire contenant l'argument date. Dans Qlik Sense, les semaines lunaires sont définies en comptant le 1er janvier comme le premier jour de la semaine et, à l'exception de la dernière semaine de l'année, elles contiendront exactement sept jours.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur d'affichage indiquant l'année et le numéro de la semaine lunaire correspondant à un horodatage de la première milliseconde du premier jour de la semaine lunaire contenant l'argument date. Dans Qlik Sense, les semaines lunaires sont définies en comptant le 1er janvier comme le premier jour de la semaine et, à l'exception de la dernière semaine de l'année, elles contiendront exactement sept jours.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la première milliseconde du jour figurant dans l'argument time. Le format de sortie par défaut correspond à l'argument TimestampFormat défini dans le script.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du jour figurant dans time. Le format de sortie par défaut correspond à l'argument TimestampFormat défini dans le script.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
Cette fonction renvoie une valeur affichant la date avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du jour contenant l'argument time.
dayname(timestamp [, shift = 0 [, dayoffset = 0]])
Fonctions de numérotation des jours
La fonction age renvoie l'âge atteint à l'heure définie dans l'argument timestamp (en années) d'une personne née le jour défini par la valeur date_of_birth.
age(timestamp, date_of_birth)
La fonction networkdays renvoie le nombre de jours ouvrables (du lundi au vendredi) compris entre les valeurs start_date et end_date (incluses) en tenant compte de tous les arguments holiday facultatifs répertoriés.
networkdays (start:date, end_date {, holiday})
La fonction firstworkdate renvoie la date de début la plus récente pour atteindre la valeur no_of_workdays (du lundi au vendredi) se terminant au plus tard à la date définie par la valeur end_date, en tenant compte des jours de congé facultatifs indiqués. Les valeurs des arguments end_date et holiday doivent correspondre à des dates ou à des horodatages valides.
firstworkdate(end_date, no_of_workdays {, holiday} )
La fonction lastworkdate renvoie la première date de fin permettant d'atteindre la valeur de l'argument no_of_workdays (du lundi au vendredi) si celle-ci commence à la date définie par start_date en tenant compte de tous les arguments holiday facultatifs répertoriés. Les valeurs des arguments start_date et holiday doivent correspondre à des dates ou à des horodatages valides.
lastworkdate(start_date, no_of_workdays {, holiday})
Cette fonction calcule le numéro de jour de l'année dans lequel tombe un horodatage. Le calcul est effectué à partir de la première milliseconde du premier jour de l'année, mais le premier mois peut être décalé.
daynumberofyear(date[,firstmonth])
Cette fonction calcule le numéro de jour du trimestre dans lequel tombe un horodatage. Cette fonction est utilisée lors de la création d'un Calendrier principal.
daynumberofquarter(date[,firstmonth])