Fonctions d'extraction

Les fonctions d'extraction extraient des sous-zones à partir de dates ou d'intervalles de temps, en ciblant le jour ou une heure à partir d'une valeur de date. Vous pouvez ainsi classer les événements par jour de la semaine, saison, période de travail, etc.

Chaque fonction d'extraction commence par XDATE, suivi d'un point, du nom de la sous-fonction (ce que vous souhaitez extraire) et d'un argument.

XDATE.DATE. XDATE.DATE(valeur_date). Numérique. Retourne la partie date d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date. Pour afficher le résultat sous la forme d'une date, appliquez un format de temps à la variable.

XDATE.HOUR. XDATE.HOUR(date-heure). Numérique. Renvoie l'heure (un entier entre 0 et 23) à partir d'une valeur représentant une heure ou une date-heure. L'argument peut être un nombre, une variable d'heure ou de date-heure ou une expression dont le résultat est une heure ou une date-heure.

XDATE.JDAY. XDATE.JDAY(valeur_date). Numérique. Renvoie le jour de l'année (un entier entre 1 et 366) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.MDAY. XDATE.MDAY(valeur_date). Numérique. Renvoie le jour du mois (un entier entre 1 et 31) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.MINUTE. XDATE.MINUTE(date-heure). Numérique. Renvoie la minute (un entier entre 0 et 59) à partir d'une valeur représentant une date-heure ou une heure. L'argument peut être un nombre, une variable d'heure ou de date-heure ou une expression dont le résultat est une heure ou une date-heure.

XDATE.MONTH. XDATE.MONTH(valeur_date). Numérique. Renvoie le mois (un entier entre 1 et 12) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.QUARTER. XDATE.QUARTER(valeur_date). Numérique. Renvoie le trimestre de l'année (un entier entre 1 et 4) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.SECOND. XDATE.SECOND(date-heure). Numérique. Renvoie la seconde (un entier entre 0 et 60) à partir d'une valeur représentant une date-heure ou une heure. L'argument peut être un nombre, une variable d'heure ou de date-heure ou une expression dont le résultat est une heure ou une date-heure.

XDATE.TDAY. XDATE.TDAY(valeurtemps). Numérique. Renvoie le nombre de jours entiers (sous la forme d'un entier) d'une valeur numérique qui représente un intervalle de temps. L'argument peut être un nombre, une variable de format d'heure ou une expression dont le résultat est une date.

XDATE.TIME. XDATE.TIME(date-heure). Numérique. Renvoie la portion heure d'une valeur qui représente une heure ou une date-heure. L'argument peut être un nombre, une variable d'heure ou de date-heure ou une expression dont le résultat est une heure ou une date-heure. Pour afficher le résultat sous la forme d'une heure, appliquez un format d'heure à la variable.

XDATE.WEEK. XDATE.WEEK(valeur_date). Numérique. Renvoie la semaine (un entier entre 1 et 53) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.WKDAY. XDATE.WKDAY(valeur_date). Numérique. Renvoie le jour de la semaine (un entier entre 1, dimanche, et 7, Samedi) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

XDATE.YEAR. XDATE.YEAR(valeur_date). Numérique. Renvoie l'année (sous la forme d'un entier à quatre chiffres) à partir d'une valeur numérique qui représente une date. L'argument peut être un nombre, une variable au format date, ou une expression dont le résultat est une date.

Exemple

DATA LIST FREE (",") 
  /StartDateTime (datetime25).
BEGIN DATA
29-OCT-2003 11:23:02
1 January 1998 1:45:01
21/6/2000 2:55:13
END DATA.
COMPUTE dateonly=XDATE.DATE(StartDateTime).
FORMATS dateonly(ADATE10).
COMPUTE hour=XDATE.HOUR(StartDateTime).
COMPUTE DayofWeek=XDATE.WKDAY(StartDateTime).
COMPUTE WeekofYear=XDATE.WEEK(StartDateTime).
COMPUTE quarter=XDATE.QUARTER(StartDateTime).

La partie date extraite avec XDATE.DATE renvoie une date exprimée en secondes. Par conséquent, FORMATS est utilisé pour afficher la date dans un format de date lisible.
Le jour de la semaine est un entier compris entre 1 (dimanche) et 7 (samedi).
La semaine de l'année est un entier compris entre 1 et 53 (1er janvier-7 = 1).