Fonctions de transformation de la date et de l’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 la date et de l’heure. Si une fonction de transformation de la date et de l’heure est appliquée à un type de pastille de données incorrect, 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, reportez-vous à la section 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.


Pastille de données d’entrée	Paramètres	Pastille 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 - Temps à 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.


Pastille de données d’entrée	Paramètres	Pastille 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 une durée à 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 l’heure localise ensuite la valeur du champ Créé en soustrayant trois heures de l’entrée Date/heure.

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.


Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Chaîne mise en forme comme spécifié dans le fichier Input Date Format	Input Date Format - Date/heure ou format de date de la chaîne d’entrée Custom Format - Format date/heure ou date valide 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é est incomplète, la transformation crée une valeur Date/Heure complète à l’aide des dates et heures 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é MMM aaaa produisent une sortie de 01-10-2019 00 :00 :00.
Si vous utilisez un type de pastille de données incorrect ou un format personnalisé non valide, le flux est annulé 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 entrer un format personnalisé pour l’entrée Date/Heure.


Pastille de données d’entrée	Paramètres	Pastille 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 - Format date/heure ou date valide représenté sous forme de chaîne. Nécessaire 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 de date.


Chaîne	Description	Format de sortie	Exemple
G	Désignateur d’ère	Texte	AD
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 de la semaine	Texte	Mercredi; Mer
U	Nombre de jours de la semaine	Numéro	3
a	matin ou après-midi	Texte	H.
H	Heure du jour de 0 à 23	Numéro	0
k	Heure du jour de 13h à 24h	Numéro	24
K	Heure du matin ou de l’après-midi de 0 à 11 heures	Numéro	0
h	Heure du matin ou de l’après-midi de 13 h à 12 h	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.


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

Figure 7. Exemple

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

Heure

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


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

Figure 8. Exemple

Entrée : 2021-11-20 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/heure spécifiée.


Pastille de données d’entrée	Pastille 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 : 2021-11-20 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.


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

Figure 10. Exemple

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

Mois

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


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

Figure 11. Exemple

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

Semaine

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


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

Figure 12. Exemple

Entrée : 2021-04-07 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.


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

Figure 13. Exemple

Entrée : 2021-04-07 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 Epoch (1970-01-01 00 :00 :00).


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

Figure 14. Exemple

Entrée : 2021-05-02 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.


Pastille de données d’entrée	Paramètres	Pastille 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’addition 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