Fonctions de date et d'heure (SPSS Modeler) | IBM Cloud Pak for Data as a Service

Retourner à la version anglaise de la documentation

Fonctions de date et d'heure

Dernière mise à jour : 07 oct. 2024

Fonctions de date et d'heure (SPSS Modeler)

Le langage CLEM comprend une série de fonctions permettant de manipuler des champs avec un stockage datetime contenant des variables de chaîne représentant des dates et des heures.

Les formats de date et d'heure utilisés sont spécifiques à chaque flux et sont spécifiés dans les propriétés de flux. Les fonctions de date et d'heure analysent les chaînes de date et d'heure en fonction du format sélectionné.

Lorsque vous spécifiez un an à une date qui n'utilise que deux chiffres (c'est-à-dire, le siècle n'est pas spécifié), SPSS Modeler utilise le siècle par défaut spécifié dans les propriétés de flux.

Tableau 1. Fonctions de date et d'heure CLEM
Fonction	Résultat	Descriptif
`@TODAY`	Chaîne	Si vous sélectionnez Jours / minutes de remplacement dans les propriétés de flux, cette fonction renvoie la date en cours sous forme de chaîne dans le format de date en cours. Si vous utilisez un format de date à deux chiffres et que vous ne sélectionnez pas Jours / minutes de remplacement, cette fonction renvoie $null$ sur le serveur en cours.
`to_time(ITEM)`	Heure	Convertit le stockage du champ spécifié en une heure.
`to_date(ITEM)`	Date	Convertit le stockage du champ spécifié en une date.
`to_timestamp(ITEM)`	Horodatage	Convertit le stockage du champ spécifié en un horodatage.
`to_datetime(ITEM)`	Datetime	Convertit le stockage du champ spécifié en une valeur d'heure, de date ou d'horodatage.
`datetime_date(ITEM)`	Date	Renvoie la valeur de date pour un nombre, une chaîne, ou un horodatage. Veuillez noter que cette fonction est la seule fonction vous permettant de reconvertir un nombre (en secondes) en date. Si `ITEM` est une chaîne, crée une date en analysant une chaîne au format de date sélectionné. Le format de date indiqué dans les propriétés de flux doit être correct pour que cette fonction soit réussie. Si `ITEM` est un nombre, il est interprété comme un nombre de secondes depuis la date de base (ou époque). Les fractions de jour sont supprimées. Si `ITEM` est un horodatage, la partie date de cet horodatage est renvoyée. Si `ITEM` est une date, elle est retournée inchangée.
`date_before(DATE1, DATE2)`	Booléen	Renvoie une valeur true (vrai) si DATE1 représente une date ou un horodatage antérieur à DATE2. Sinon, cette fonction renvoie la valeur 0.
`date_days_difference(DATE1, DATE2)`	Entier	Renvoie la durée en jours depuis la date ou l'horodatage qui sépare DATE1 de DATE2, sous forme d'entier. Si DATE2 est antérieure à DATE1, cette fonction renvoie un nombre négatif.
`date_in_days(DATE)`	Entier	Renvoie la durée en jours qui sépare la date ou l'horodatage de référence de l'élément DATE indiqué, sous la forme d'un entier. Si DATE est antérieure à la date de référence, cette fonction renvoie un nombre. Vous devez inclure une date réelle pour que le calcul fonctionne correctement. Par exemple, vous ne devez pas entrer la date : 29 février 2001. Parce que 2001 n'est pas une année bissextile, cette date n'existe pas.
`date_in_months(DATE)`	Réel	Renvoie la durée en mois qui sépare la date ou l'horodatage de référence de l'élément DATE indiqué, sous la forme d'un nombre réel. Ce chiffre est approximatif et utilise une base de 30.4375 jours par mois. Si DATE est antérieure à la date de référence, cette fonction renvoie un nombre. Vous devez inclure une date réelle pour que le calcul fonctionne correctement. Par exemple, vous ne devez pas entrer la date : 29 février 2001. Parce que 2001 n'est pas une année bissextile, cette date n'existe pas.
`date_in_weeks(DATE)`	Réel	Renvoie la durée en semaines qui sépare la date ou l'horodatage de référence de l'élément DATE indiqué, sous la forme d'un nombre réel. La semaine de base utilisée comprend 7,0 jours. Si DATE est antérieure à la date de référence, cette fonction renvoie un nombre. Vous devez inclure une date réelle pour que le calcul fonctionne correctement. Par exemple, vous ne devez pas entrer la date : 29 février 2001. Parce que 2001 n'est pas une année bissextile, cette date n'existe pas.
`date_in_years(DATE)`	Réel	Renvoie la durée en années qui sépare la date ou l'horodatage de référence de l'élément DATE indiqué, sous la forme d'un nombre réel. Ce chiffre est approximatif et utilise une base de 365.25 jours. Si DATE est antérieure à la date de référence, cette fonction renvoie un nombre. Vous devez inclure une date réelle pour que le calcul fonctionne correctement. Par exemple, vous ne devez pas entrer la date : 29 février 2001. Parce que 2001 n'est pas une année bissextile, cette date n'existe pas.
`date_months_difference (DATE1, DATE2)`	Réel	Renvoie la durée en mois depuis la date ou l'horodatage qui sépare DATE1 de DATE2, sous forme d'un nombre réel. Ce chiffre est approximatif et utilise une base de 30.4375 jours par mois. Si DATE2 est antérieure à DATE1, cette fonction renvoie un nombre négatif.
`datetime_date(YEAR, MONTH, DAY)`	Date	Renvoie la valeur de date pour les éléments YEAR, MONTH et DAY (année, mois, jour) indiqués. Ces arguments doivent être des entiers.
`datetime_day(DATE)`	Entier	Renvoie le jour du mois à partir de la valeur DATE ou d'un horodatage. Le résultat est un entier compris entre 1 et 31.
`datetime_day_name(DAY)`	Chaîne	Renvoie le nom complet de l'élément DAY (jour) indiqué. L'argument doit être un entier compris entre 1 (dimanche) et 7 (samedi).
`datetime_hour(TIME)`	Entier	Renvoie l'heure à partir de la valeur TIME ou d'un horodatage. Le résultat est un entier compris entre 0 et 23.
`datetime_in_seconds(TIME)`	Réel	Renvoie la partie des secondes stockée dans TIME.
`datetime_in_seconds(DATE)`, `datetime_in_seconds(DATETIME)`	Réel	Renvoie le chiffre cumulé, converti en secondes, de la différence entre la date DATE ou DATETIME actuelle et la date de référence (1900-01-01).
`datetime_minute(TIME)`	Entier	Renvoie le nombre de minutes, à partir de TIME ou d'un horodatage. Le résultat est un entier compris entre 0 et 59.
`datetime_month(DATE)`	Entier	Renvoie le mois, à partir de DATE ou d'un horodatage. Le résultat est un entier compris entre 1 et 12.
`datetime_month_name (MONTH)`	Chaîne	Renvoie le nom complet de l'élément MONTH (mois) indiqué. L'argument doit être un entier compris entre 1 et 12.
`datetime_now`	Horodatage	Renvoie l'heure actuelle sous la forme d'un horodatage.
`datetime_second(TIME)`	Entier	Renvoie le nombre de secondes, à partir de TIME ou d'un horodatage. Le résultat est un entier compris entre 0 et 59.
`datetime_day_short_name` `(DAY)`	Chaîne	Renvoie le nom abrégé de l'élément DAY (jour) indiqué. L'argument doit être un entier compris entre 1 (dimanche) et 7 (samedi).
`datetime_month_short_name` `(MONTH)`	Chaîne	Renvoie le nom abrégé de l'élément MONTH (mois) indiqué. L'argument doit être un entier compris entre 1 et 12.
`datetime_time(HOUR, MINUTE, SECOND)`	Heure	Renvoie la valeur d'heure pour les éléments HOUR, MINUTE et SECOND (heures, minutes, secondes) indiqués. Ces arguments doivent être des entiers.
`datetime_time(ITEM)`	Heure	Renvoie la valeur d'heure de l'élément ITEM indiqué.
`datetime_timestamp(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND)`	Horodatage	Renvoie la valeur d'horodatage pour les éléments YEAR, MONTH, DAY, HOUR, MINUTE et SECOND (année, mois, jour, heures, minutes, secondes) indiqués.
`datetime_timestamp(DATE, TIME)`	Horodatage	Renvoie la valeur d'horodatage des éléments DATE et TIME (date, heure) indiqués.
`datetime_timestamp` `(NUMBER)`	Horodatage	Renvoie la valeur d'horodatage du nombre de secondes indiqué.
`datetime_weekday(DATE)`	Entier	Renvoie le jour de la semaine à partir de la valeur DATE ou d'un horodatage.
`datetime_year(DATE)`	Entier	Renvoie l'année, à partir de DATE ou d'un horodatage. Le résultat est un nombre entier tel que 2021.
`date_weeks_difference` `(DATE1, DATE2)`	Réel	Renvoie la durée en semaines depuis la date ou l'horodatage qui sépare DATE1 de DATE2, sous forme d'un nombre réel. La semaine de base utilisée comprend 7,0 jours. Si DATE2 est antérieure à DATE1, cette fonction renvoie un nombre négatif.
`date_years_difference (DATE1, DATE2)`	Réel	Renvoie la durée en années depuis la date ou l'horodatage qui sépare DATE1 de DATE2, sous forme d'un nombre réel. Ce chiffre est approximatif et utilise une base de 365.25 jours. Si DATE2 est antérieure à DATE1, cette fonction renvoie un nombre négatif.
`date_from_ywd(YEAR, WEEK, DAY)`	Entier	Convertit l'année, la semaine dans l'année et le jour de la semaine, en une date au format ISO 8601.
`date_iso_day(DATE)`	Entier	Renvoie le jour de la semaine de la date au format ISO 8601.
`date_iso_week(DATE)`	Entier	Renvoie la semaine de l'année de la date au format ISO 8601.
`date_iso_year(DATE)`	Entier	Renvoie l'année de la date au format ISO 8601.
`time_before(TIME1, TIME2)`	Booléen	Renvoie une valeur true (vrai) si TIME1 représente une heure ou un horodatage antérieur à TIME2. Sinon, cette fonction renvoie la valeur 0.
`time_hours_difference (TIME1, TIME2)`	Réel	Renvoie la durée en heures qui sépare les heures ou les horodatages représentés par TIME1 et TIME2, sous la forme d'un nombre réel. Si vous sélectionnez Jours / minutes de remplacement dans les propriétés de flux, une valeur plus élevée de TIME1 est prise pour faire référence à la date précédente. Si vous ne sélectionnez pas l'option de remplacement, une valeur plus élevée de TIME1 entraîne une valeur négative pour la valeur renvoyée.
`time_in_hours(TIME)`	Réel	Renvoie le nombre d'heures représenté par l'heure TIME, sous la forme d'un nombre réel. Par exemple, pour le format d'heure `HHMM`, l'expression `time_in_hours('0130')` renvoie la valeur 1,5. TIME peut représenter une heure ou un horodatage.
`time_in_mins(TIME)`	Réel	Renvoie le nombre de minutes représenté par l'heure TIME, sous la forme d'un nombre réel. TIME peut représenter une heure ou un horodatage.
`time_in_secs(TIME)`	Entier	Renvoie le nombre de secondes représenté par l'heure TIME, sous la forme d'un entier. TIME peut représenter une heure ou un horodatage.
`time_mins_difference(TIME1, TIME2)`	Réel	Renvoie la durée en minutes qui sépare les heures ou les horodatages représentés par TIME1 et TIME2, sous la forme d'un nombre réel. Si vous sélectionnez Jours / minutes de remplacement dans les propriétés de flux, une valeur plus élevée de TIME1 est prise pour faire référence au jour précédent (ou à l'heure précédente, si seulement les minutes et les secondes sont spécifiées dans le format en cours). Si vous ne sélectionnez pas l'option de remplacement, une valeur plus élevée de TIME1 entraînera une valeur négative pour la valeur renvoyée.
`time_secs_difference(TIME1, TIME2)`	Entier	Renvoie la durée en secondes qui sépare l'heure ou l'horodatage représenté par TIME1 de celle représentée par TIME2, sous la forme d'un entier. Si vous sélectionnez Jours / minutes de remplacement dans les propriétés de flux, une valeur plus élevée de TIME1 est prise pour faire référence au jour précédent (ou à l'heure précédente, si seulement les minutes et les secondes sont spécifiées dans le format en cours). Si vous ne sélectionnez pas l'option de remplacement, une valeur plus élevée de TIME1 entraîne une valeur négative pour la valeur renvoyée.