Fonctions de transformation de date et d’heure

Les fonctions de transformation de date et d’heure nécessitent une pastille de données d’entrée date/heure ou chaîne. Certaines fonctions prennent également en charge les pastilles de données de durée. Assurez-vous d’utiliser le type de pastille de données d’entrée correct lors de l’application des fonctions de transformation de date et d’heure. Si une fonction de transformation de date et d’heure est appliquée à un type de pastille de données inapproprié, les données ne sont pas transformées pendant l’exécution et la valeur d’entrée est renvoyée à la place. Pour plus d’informations sur la confirmation des valeurs d’exécution de votre flux, consultez Tester un flux.

Remarque :

Les valeurs Date/heure d’exécution ne sont pas localisées et s’affichent dans le fuseau horaire UTC (Temps universel coordonné). Pour plus d’informations, voir Fuseaux horaires et représentation des fuseaux horaires.

Ajouter une heure

Ajoute des jours, des heures, des minutes ou des secondes à une entrée Date/heure, Date, Date d’échéance ou Durée.


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Date/Heure, Date, Date d’échéance ou Durée Remarque : Si l’entrée est une date ou une date d’échéance, la transformation crée une valeur Date/Heure complète à l’aide de valeurs horaires correspondant à heure 0, minute 0 et seconde 0.	Duration - Durée à ajouter en jours, heures, minutes et secondes	Date/Heure : valeur Date/Heure transformée après addition de la valeur spécifiée Duration

Figure 1. Exemple

Entrée : 2019-09-12 11:00:00
Durée : 3 heures
Sortie : 2019-09-12 14:00:00

Soustraire l'heure

Soustrait les jours, heures, minutes et/ou secondes de Date/heure, Date, Date d’échéance ou Durée de l’entrée.


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Date/Heure, Date, Date d’échéance ou Durée Remarque : Si l’entrée est une date ou une date d’échéance, la transformation crée une valeur Date/Heure complète à l’aide de valeurs horaires correspondant à heure 0, minute 0 et seconde 0.	Duration - Entrez un temps à soustraire en jours, heures, minutes et secondes	Date/Heure : valeur Date/Heure transformée après soustraction de la valeur spécifiée Duration

Figure 2. Exemple

Entrée : 2019-09-12 11:00:00
Durée : 2 jours, 1 heure, 5 minutes, 10 secondes
Sortie : 2019-09-10 09:54:50

Dans cet exemple, le flux récupère un enregistrement d’élément de configuration CMDB à partir d’une instance distante. La fonction de transformation Soustraire le temps localise ensuite la valeur du champ Créé en soustrayant trois heures de la date/heure entrée.

Localisez le fuseau horaire d’une valeur de champ. — Figure 3. Localiser le fuseau horaire d’une valeur de champ

Chaîne à date

Convertit la chaîne d'entrée en Date/heure.


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Chaîne mise en forme comme spécifié dans le fichier Input Date Format	Input Date Format : format date/heure ou date de la chaîne d’entrée Custom Format - Date/heure valide ou format de date représenté sous forme de chaîne. Nécessaire uniquement si l’option Format personnalisé est sélectionnée comme .Input Date Format	Date/Heure

Remarque :

Si la valeur Date/Heure de l’entrée Format personnalisé n’est pas complète, la transformation crée une valeur Date/Heure complète à l’aide des dates et valeurs par défaut. Dans ce cas, la transformation utilise par défaut l’année en cours, le mois en cours, le jour 1 du mois, heure 0, minute 0 et seconde 0. Par exemple, une valeur de pastille de données d’entrée Oct 2019 et un format de date personnalisé de MMM aaaa produisent une sortie de 2019-10-01 00:00:00.
Si vous utilisez un type de pastille de données incorrect ou un format personnalisé non valide, le flux s’annule pendant l’exécution.

Figure 4. Exemple

Entrée : '1995-11-20'
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 1995-11-20 00:00:00

Date à chaîne

Convertit l'entrée Date/heure, Date ou Date d'échéance en une chaîne. Sélectionnez un format de date pour l’entrée Date/Heure. Vous pouvez également saisir un format personnalisé pour l’entrée Date/Heure.


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Date/Heure, Date ou Date d'échéance	Output Date Format - Date/heure ou format de date de la chaîne de sortie Custom Format - Date/heure valide ou format de date représenté sous forme de chaîne. Obligatoire uniquement si vous sélectionnez Format personnalisé comme format de date.	Chaîne mise en forme comme spécifié dans le fichier Output Date Format

Remarque :

Si vous utilisez un type de pastille de données d’entrée incorrect ou un format personnalisé non valide, le flux s’annule pendant l’exécution.

Concaténer une valeur date/heure avec une valeur de chaîne. — Figure 5. Exemple

Formats de date personnalisés

Vous pouvez spécifier un format de date personnalisé avec une séquence de chaînes de modèle de date et d’heure spécifiques. Une chaîne de modèle se compose d’une ou plusieurs lettres majuscules et minuscules de A à Z. Tout texte entre guillemets est ignoré et copié dans la sortie date.


Chaîne	Description	Format de sortie	Exemple
G	Désignateur d’ère	Texte	ANNONCE
o	Année	Année	2019; 19
Y	Semaine de l’année	Année	2019; 19
M	Mois de l’année (dans la date)	Mois	Juillet; Juil; 07
L	Mois de l’année (valeur autonome)	Mois	Juillet; Juil; 07
w	Semaine de l’année	Numéro	52
W	Semaine du mois	Numéro	1
D	Jour de l’année	Numéro	365
j	Jour du mois	Numéro	2
F	Jour de la semaine du mois	Numéro	3
E	Nom du jour dans la semaine	Texte	Mercredi; Marier
u	Nombre de jours de la semaine	Numéro	3
a	matin ou après-midi	Texte	après-midi
H	Heure dans la journée de 0 à 23	Numéro	0
k	Heure dans la journée de 1 à 24	Numéro	24
K	Heure du matin ou de l’après-midi de 0h à 11h	Numéro	0
h	Heure du matin ou de l’après-midi de 13h à 12h	Numéro	12
m	Minute dans heure	Numéro	59
s	Seconde dans minute	Numéro	1
S	Milliseconde	Numéro	500
z	Fuseau horaire au format par défaut	Fuseau horaire au format par défaut	Heure normale du Pacifique ; PST
Z	Fuseau horaire au format RFC 822	Fuseau horaire au format RFC 822	-0800
X	Fuseau horaire au format ISO 8601	Fuseau horaire au format ISO 8601	-08; -0800; -08:00

Jour

Récupère le composant jour à partir de la date/heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : jour à partir de la date spécifiée.

Figure 7. Exemple

Entrée : 20/11/2021 13:06:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 20

Heure

Récupère le composant de l’heure à partir de la date/l’heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : heure à partir de la date spécifiée.

Figure 8. Exemple

Entrée : 20/11/2021 13:06:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie :13

Minute

Récupère le composant de la minute à partir de la date/l’heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : composant de la minute à partir de la date spécifiée.

Figure 9. Exemple

Entrée : 20/11/2021 13:06:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 06

Deuxième

Récupère le deuxième composant à partir de la date/heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : deuxième composant à partir de la date spécifiée.

Figure 10. Exemple

Entrée : 20/11/2021 13:06:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 12

Mois

Récupère le composant mois à partir de la date/heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : composant du mois à partir de la date spécifiée.

Figure 11. Exemple

Entrée : 20/11/2021 13:06:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 11

Semaine

Évalue le numéro de la semaine pour la date/l’heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : numéro de semaine pour la date spécifiée.

Figure 12. Exemple

Entrée : 07/04/2021 12:01:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 15

Année

Récupère le composant année à partir de la date/heure spécifiée.


Pilule de données d’entrée	Pilule de données de sortie
Date/Heure	Nombre entier : composant de l’année à partir de la date spécifiée.

Figure 13. Exemple

Entrée : 07/04/2021 12:01:12
Format de la date d’entrée : Date ISO (2004-06-28)
Sortie : 2021

Différence de date

Évalue la différence de durée entre la date d’entrée spécifiée et la date du paramètre, puis ajoute la différence de durée à l’heure d’epoch (1970-01-01 00:00:00).


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Date/Heure, Date ou Date d'échéance	Date/Heure, Date ou Date d'échéance	Durée : différence de durée ajoutée à l’heure d’Epoch (1970-01-01 00:00:00).

Figure 14. Exemple

Entrée : 02/05/2021 09:10:12
Format de la date d’entrée : Date ISO (2004-06-28)
Paramètres : 2021-04-07 06:02:23
Sortie : 1970-01-26 03:07:49

Fin du mois

Évalue le dernier jour du mois après avoir ajouté le nombre spécifié de mois à la date spécifiée.


Pilule de données d’entrée	Paramètres	Pilule de données de sortie
Date	Nombre de mois : mois à ajouter à la date spécifiée.	Nombre entier : dernier jour du mois après l’ajout du nombre de mois à la date d’entrée spécifiée.

Figure 15. Exemple

Entrée : 2021-11-20
Format de la date d’entrée : Date ISO (2004-06-28)
Nombre de mois : 3
Sortie : 2022-02-28