Les fonctions de date et heure de QlikView sont destinées à transformer et à convertir les valeurs de date et heure. Les fonctions s'utilisent toutes aussi bien dans le script de chargement 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.
QlikView 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, QlikView 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, QlikView 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 comprenant une fonction de date ou d'heure, QlikView ignore les éventuels paramètres d'heure d'été, à moins que la fonction de date ou d'heure ne comprenne une position géographique.
Par exemple, ConvertToLocalTime( filetime('Time.qvd'), 'Paris') appliquerait les paramètres d'heure d'été, tandis que ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') n'en tiendrait pas compte.
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(timestamp [, first_week_day [, broken_weeks [, reference_day]]])
Cette fonction renvoie une valeur double composée d'un nom de mois tel que défini dans la variable d'environnement MonthNames et d'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 définie par l'horloge système. La valeur par défaut est de 1.
now([ timer_mode])
Cette fonction renvoie la date actuelle définie par l'horloge système.
today([timer_mode])
Cette fonction renvoie un horodatage de l'heure actuelle d'après l'horloge système 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 la date d'entrée 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(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Fonctions de fuseau horaire
Cette fonction renvoie le nom du fuseau horaire actuel, tel qu'il est défini dans Windows, sans tenir compte du réglage de l'heure d'été,.
timezone( )
Cette fonction renvoie la date et l'heure Greenwich Mean Time actuelle, telle qu'elle est indiquée par les paramètres d'heure de l'horloge système et de Windows.
GMT( )
Renvoie la date et le temps universel coordonné (Coordinated Universal Time) actuel.
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 ou de 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 timestamp se trouve dans la partie du mois comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.
inmonthtodate (date, basedate , shift)
Cette fonction permet de déterminer si un horodatage tombe pendant le même mois, la même période de deux mois, le même trimestre, la même période de quatre mois ou le même 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 de 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 renvoie la valeur true si l'argument timestamp se trouve dans la semaine lunaire comprenant l'argument base_date. Les semaines lunaires figurant dans QlikView sont définies en comptant le 1er janvier comme le premier jour de la semaine.
inlunarweek (date, basedate , shift [, weekstart])
Cette fonction renvoie la valeur true si l'argument timestamp se trouve dans la partie de la semaine lunaire jusqu'à la dernière milliseconde spécifiée dans base_date. Les semaines lunaires figurant dans QlikView sont définies en comptant le 1er janvier comme le premier jour de la semaine.
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.
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 (lundi) 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 de la semaine lunaire contenant l'argument date. Les semaines lunaires figurant dans QlikView sont définies en comptant le 1er janvier comme le premier jour de la semaine.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde de la semaine lunaire contenant l'argument date. Les semaines lunaires figurant dans QlikView sont définies en comptant le 1er janvier comme le premier jour de la semaine.
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. Les semaines lunaires figurant dans QlikView sont définies en comptant le 1er janvier comme le premier jour de la semaine.
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. 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.
daynumberofquarter(date[,firstmonth])
