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 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, voir Fuseaux horaires et représentation des fuseaux horaires.

Ajouter une heure

Ajoute des jours, heures, minutes ou 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 - 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 : 12/09/2019 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 de date/heure transformée après soustraction de la valeur spécifiée Duration

Figure 2. Exemple

Entrée : 12/09/2019 11:00:00
Durée : 2 jours, 1 heures, 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 la Date/Heure en entrée.

Localise 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 indiqué dans le Input Date Format	Input Date Format - Format date/heure ou date de la chaîne d’entrée Custom Format - Format Date/Heure ou date valide représenté sous forme de chaîne. Requis uniquement si Format personnalisé est sélectionné 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 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 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 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 saisir un format personnalisé pour la date/heure d’entrée.


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 - Format date/heure ou date de la chaîne de sortie Custom Format - Format Date/Heure ou date valide représenté sous forme de chaîne. Requis uniquement si vous sélectionnez Format personnalisé comme format de date.	Chaîne mise en forme comme indiqué dans le 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 est annulé pendant l’exécution.

Concaténez 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èles 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ésignation 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	Numéro de jour de la semaine	Numéro	3
a	matin ou après-midi	Texte	p.m.
H	Heure dans la journée de 0 à 23	Numéro	0
k	Heure dans la journée de 1 à 24 heures	Numéro	24
K	Heure en heures du matin ou de l’après-midi de 0 à 11 heures	Numéro	0
h	Heure en matinée ou en 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.


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 : 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/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 : 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/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 : 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.


Pastille de données d’entrée	Pastille de données de sortie
Date/Heure	Nombre entier : deuxième composant 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.


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 : 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 semaine pour la date/l’heure spécifiée.


Pastille de données d’entrée	Pastille de données de sortie
Date/Heure	Nombre entier : numéro de semaine correspondant à 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 de l’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 de l’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 durée de la différence de temps à 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 : différence de durée ajoutée à l’heure d’époque (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 avoir ajouté le 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