Guide de référence du module Date/Time

Propriété	Type	Description
years	Nombre	Un nombre à quatre chiffres représentant l’année de la date spécifiée.
months	Nombre	Représente le mois de l’année à la date indiquée. Janvier est égal à 1.
date	Nombre	Représente la date du mois à la date indiquée.
hours	Nombre	Représente les heures du jour à une date ou un moment spécifique.
minutes	Nombre	Représente les minutes d’une heure à une date ou un moment spécifique.
seconds	Nombre	Représente les secondes dans une minute à une date ou un moment spécifique.
milliseconds	Nombre	Représente les millisecondes dans une seconde à une date ou un moment spécifique.
offset	Chaîne	Le décalage par rapport au temps universel coordonné (UTC) dans une chaîne au format ±HH:mm.
iso	Chaîne	Une chaîne représentant la date/l’heure dans une chaîne au format standard ISO-8601. Par exemple : AAAA-MM-JJTHH:mm:ssZ
utc	Chaîne	Une chaîne représentant la date/l’heure dans une chaîne au format UTC standard ISO-8601.
unix	Nombre	Un nombre représentant l’horodatage Unix de la date/l’heure.
isValid	Booléen	Une valeur booléenne indiquant si la date/l’heure est valide ou non.

Propriété	Type	Description
years	Nombre	Un entier représentant le nombre d’années écoulées entre les deux dates.
months	Nombre	Un entier représentant le nombre de mois écoulés après avoir calculé le nombre d’années entre les deux dates.
days	Nombre	Un entier représentant le nombre de jours écoulés après avoir calculé le nombre de mois et d’années entre les deux dates.
hours	Nombre	Un entier représentant le nombre d’heures écoulées après avoir calculé le nombre de jours, de mois et d’années entre les deux dates.
minutes	Nombre	Un entier représentant le nombre de minutes écoulées après avoir calculé le nombre d’heures, de jours, de mois et d’années entre les deux dates.
seconds	Nombre	Un entier représentant le nombre de secondes écoulées après avoir calculé le nombre de minutes, d’heures, de jours, de mois et d’années entre les deux dates.
milliseconds	Nombre	Un entier représentant le nombre de millisecondes écoulées après avoir calculé le nombre de secondes, de minutes, d’heures, de jours, de mois et d’années entre les deux dates.
iso	Chaîne	Une chaîne représentant la durée dans une chaîne au format standard ISO-8601.
humanized	Chaîne	Une chaîne représentant le temps dans un format lisible par l’homme. Réponse similaire au module Format Date/Time avec une mise en forme relative. Par exemple, « 2 years ».
isDuration	Booléen	Valeur booléenne indiquant s’il s’agit d’un objet de durée ou non. Cela sera toujours vrai si l’objet est valide.
isValid	Booléen	Une valeur booléenne indiquant si la date/l’heure est valide ou non.
in	Objet	Chaque valeur de cet objet est similaire à la propriété de ce tableau, mais ignore toutes les autres unités de temps. Par exemple : une durée exacte de 2 ans entre deux dates représente 24 mois.

	Jeton	Résultat
Mois	M	1 2 … 11 12
	Mo	1st 2nd … 11th 12th
	MM	01 02 … 11 12
	MMM	Jan Feb … Nov Dec
	MMMM	January February … November December
Trimestre	T	1 2 3 4
	Qo	1st 2nd 3rd 4th
Jour du mois	D	1 2 … 30 31
	Do	1st 2nd … 30th 31st
	DD	01 02 … 30 31
Jour de l’année	DDD	1 2 … 364 365
	DDDo	1st 2nd … 364th 365th
	DDDD	001 002 … 364 365
Jour de la semaine	d	0 1 … 5 6
	do	0th 1st … 5th 6th
	dd	Su Mo… Fr Sa
	ddd	Sun Mon… Fri Sat
	dddd	Sunday Monday… Friday Saturday
Jour de la semaine (paramètres régionaux)	e	0 1 … 5 6
Jour de la semaine (ISO)	E	1 2 … 6 7
Semaine de l’année	w	1 2 … 52 53
	wo	1st 2nd … 52nd 53rd
	ww	01 02 … 52 53
Semaine de l’année (ISO)	W	1 2 … 52 53
	Wo	1st 2nd … 52nd 53rd
	WW	01 02 … 52 53
Année	YY	70 71 … 29 30
	YYYY	1970 1971 … 2029 2030
	Y	1970 1971 … 9999 +10000 +10001 Remarque : ce format est conforme à la norme ISO 8601 pour les dates postérieures à 9999
Semaine de l’année	gg	70 71 … 29 30
	gggg	1970 1971 … 2029 2030
Semaine de l’année (ISO)	GG	70 71 … 29 30
	GGGG	1970 1971 … 2029 2030
AM/PM	A	AM, PM
	a	am, pm
Heure	H	0 1 … 22 23
	HH	00 01 … 22 23
	h	1 2 … 11 12
	hh	01 02 … 11 12
	k	1 2 … 23 24
	kk	01 02 … 23 24
Minute	m	0 1 … 58 59
	mm	00 01 … 58 59
Seconde	s	0 1 … 58 59
	ss	00 01 … 58 59
Fraction de seconde	S	0 1 … 8 9
	SS	00 01 … 98 99
	SSS	000 001 … 998 999
	SSSS… SSSSSSSSS	000[0..], 001[0..]… 998[0..], 999[0..]
Fuseau horaire	z ou zz	EST CST … MST PST
	Z	-07:00 -06:00 … +06:00 +07:00
	ZZ	-0700 -0600 … +0600 +0700
Horodatage Unix	X	1360013296
Horodatage Unix en millisecondes	x	1360013296123

 

Module Check Date/Time

Le module Check Date/Time vérifie une date d’entrée par rapport à des conditions spécifiées et oriente le flux de travail en conséquence.

La façon la plus simple de l’utiliser est de faire référence à l’ensemble de l’objet Date/Time.

 

Champs du module Check Date/Time

• Date : une entrée obligatoire à vérifier par comparaison. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Condition : spécifiez l’opération conditionnelle à vérifier par rapport à la date d’entrée. Les options disponibles sont les suivantes :
  • Day of Week : oriente le flux de travail sur le chemin « Success » si la date correspond à l’un des jours sélectionnés.
  • Is Before another Date : oriente le flux de travail sur le chemin « Success » si la date est antérieure (ou identique) à une date de référence fournie.
  • Is After another Date : oriente le flux de travail sur le chemin « Success » si la date est postérieure (ou identique) à une date de référence fournie.
  • Is Between two Dates : oriente le flux de travail sur le chemin « Success » si la date est antérieure (ou identique) et postérieure (ou identique) à une date de référence fournie.
  • Between two Dates : oriente le flux de travail sur le chemin « Réussi » si la date correspond à une année bissextile. Orientera le flux de travail sur le chemin « Failed » si la date ne correspond pas à une année bissextile ou si la date ne contient pas d’année, par exemple, si seul le mois est saisi ou référencé.

Dates de référence

Si vous choisissez de vérifier si une date est antérieure, postérieure ou comprise entre une ou plusieurs dates de référence, ces entrées sont requises. Ces entrées peuvent être une chaîne au format « ISO-8601 », un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.

Dates de référence inclusives

Lorsque vous utilisez des dates de référence, les dates sont considérées comme exclusives par défaut (par exemple, Is Before and not the same as). Si vous définissez ce paramètre sur True, la condition sera calculée en fonction de dates de référence inclusives (par exemple, Is Before or same as).

Module Compare Date/Time

Le module Compare Date/Time compare deux objets Date/Time, calculant la différence absolue entre eux.

Champs du module Compare Date/Time

• First Date : une date d’entrée obligatoire à comparer. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Second Date : une date d’entrée obligatoire avec laquelle effectuer une comparaison. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Include End Date : si cette option est sélectionnée, la deuxième date d’entrée est incluse dans le calcul. Par exemple : la période associée à la période du lundi au vendredi représenterait 5 jours, et non 4.

Renvois du module Compare Date/Time

Si l’action du module réussit, il renvoie un objet de durée structuré.

Module Current Date/Time

Le module Current Date/Time renvoie l’instant présent sous la forme d’un objet Date/Time structuré pouvant être manipulé ou mis en forme.

Champs du module Current Date/Time

• Offset : méthode de définition du décalage UTC pour l’entrée. Les décalages horaires de -12:00 heures à +12:00 heures peuvent être définis, ou vous pouvez avoir un plus grand contrôle sur le décalage UTC grâce aux options suivantes.
  • None : l’entrée est analysée en l’état. Si aucun décalage n’est défini dans la chaîne d’entrée, aucun décalage n’est appliqué. Si vous analysez une chaîne qui comprend un décalage (par exemple, une chaîne au format ISO-8601), le décalage est alors défini sur la même valeur que le décalage de la chaîne. Par exemple, 2017-07-02T21:30:00-07:00 affichera un décalage de -07:00 heures.
  • Timezone Offset : choisissez un fuseau horaire pour calculer le décalage UTC. Ce calcul tient compte de l’heure d’été qui peut éventuellement être mise en œuvre à certaines dates dans certains fuseaux horaires.
  • Lat/Long Offset : spécifiez un emplacement à partir d’une chaîne de latitude et de longitude séparées par une virgule (,). L’heure d’été sera incluse dans le calcul du décalage. Par exemple, 47.650499,-122.350070 correspond aux régions America/Los_Angeles et donnerait -08:00 en hiver et -07:00 en été.
  • Custom Offset : définissez un décalage personnalisé au format ±HH:mm. Par exemple : plus huit heures et demie : +08:30

Données renvoyées par le module Current Date/Time

Si la chaîne d’entrée est analysée avec succès, le module renvoie un objet Date/Time structuré.

Module Format Date/Time

Le module Format Date/Time met en forme un objet Date/Time structuré en fonction d’une chaîne définie par l’utilisateur.

Champs du module Format Date/Time

• Date : une entrée requise à mettre en forme comme une chaîne. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Format : le format de la sortie renvoyée. Choisissez parmi l’une des options courantes, utilisez des jetons Date/Time pour créer un format personnalisé, ou spécifiez un autre objet Date/Time pour un format relatif.

Données renvoyées par le module Format Date/Time

Les formats suivants utilisent l’exemple de date du 11 mars 1952 à 8 h 15.

ISO-8601

Met en forme la date et heure selon la norme ISO-8601 (AAAA-MM-JJTHH:mm:ssZ) – 1952-03-11T08:15:00+00:00

YYYY-MM-DD

1952-03-11

MM/DD/YYYY

03/11/1952

DD/MM/YYYY

11/03/1952

MM/DD

03/11

DD/MM

11/03

HH:mm

08:15

HH:mm:ss

08:15:00

Customized Format

Utilisez les jetons de mise en forme Date/Time pour créer une chaîne de mise en forme personnalisée. Les caractères hors jetons sont également autorisés à créer une chaîne, par exemple, Do of MMMM, YYYY – 11th of March, 1952

Relative Format

Fournissez un autre objet Date/Time pour mettre en forme l’entrée de manière relative. L’unité de temps est arrondie à l’unité de changement la plus grande, par exemple : Fournissez une chaîne de date/heure selon la norme « ISO-8601 » sous la forme 1952-03-13T09:15:00+00:00 pour obtenir une sortie du type « il y a 2 jours », et non « il y a 2 jours et 23 heures ». Il s’agit d’un moyen simple d’obtenir des formats humanisés. Si vous souhaitez un rendu plus détaillé, consultez la section relative au module Compare Date/Time Module et à l’objet de durée qui en résulte.

Module Manipulate Date/Time

Le module Manipulate Date/Time peut manipuler un objet Date/Time structuré en ajoutant, soustrayant ou définissant des unités de temps.

 

Champs du module Manipulate Date/Time

• Operation : manipulez la date d’entrée en choisissant d’ajouter, de soustraire ou de définir des unités de temps.
  • Add : manipulez la date d’entrée en ajoutant des unités de temps.
  • Subtract : manipulez la date d’entrée en soustrayant des unités de temps.
  • Set : manipulez la date d’entrée en définissant des unités de temps.
• Date: une entrée requise à manipuler. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Years : nombre d’années à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir l’année (par exemple, 1952).
• Months : nombre de mois à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir le mois (1 - 12).
• Days : nombre de jours à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir la date du mois.
• Hours : nombre de jours à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir l’heure (0 - 23).
• Minutes : nombre de minutes à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir les minutes (0 - 59).
• Secondes : nombre de secondes à ajouter ou à soustraire de la date d’entrée. L’utilisation des champs Operation et Set permet de définir les secondes (0 - 59).
• Duration : en plus d’ajouter ou de soustraire une unité de temps, il est également possible d’ajouter ou de soustraire une durée. Elle est représentée sous la forme d’une chaîne de durée au format ISO-8601 ou d’un objet de durée tiré de la sortie du module Compare Date/Time.

Renvois du module Manipulate Date/Time

Si la chaîne d’entrée est analysée avec succès, le module renvoie un objet Date/Time structuré.

Module Parse Date/Time

Le module Parse Date/Time analyse une date sous la forme d’un objet Date/Time structuré pouvant être manipulé ou mis en forme.

En plus des dates lisibles par l’homme, ce module peut analyser des chaînes au format ISO-8601, des chaînes au format RFC 2822, des horodatages Unix ou la sortie d’un autre module Parse Date/Time. Si l’entrée n’est pas valide, un objet Invalid Date/Time est renvoyé.

 

Champs du Parse Compare Date/Time

• Date : une entrée obligatoire à analyser dans un objet Date/Time structuré. L’entrée peut être dans n’importe quel format de chaîne lisible par l’homme (ISO-8601, RFC 2822, horodatage Unix ou sortie d’un autre module Parse Date/Time).
• Locale : une entrée facultative pour fournir les paramètres régionaux de l’entrée. Les paramètres régionaux sont utilisés pour différencier les modèles courants. Par exemple, le 5 avril 2017 peut être écrit sous la forme 04/05/2017 dans les paramètres régionaux américains ou 05/04/2017 dans les paramètres régionaux britanniques. Ces modèles sont extrêmement difficiles à distinguer. Il est donc recommandé de spécifier les paramètres régionaux appropriés en fonction de vos besoins. Le format par défaut est l’américain (en).
• UTC Offset : méthode de définition du décalage UTC pour l’entrée. Les décalages horaires de -12:00 heures à +12:00 heures peuvent être définis, ou vous pouvez avoir un plus grand contrôle sur le décalage UTC grâce aux options suivantes.
  • None : l’entrée est analysée en l’état. Si aucun décalage n’est défini dans la chaîne d’entrée, aucun décalage n’est appliqué. Si vous analysez une chaîne qui comprend un décalage (par exemple, une chaîne au format « ISO-8601 »), le décalage est alors défini sur la même valeur que le décalage de la chaîne. Par exemple, 2017-07-02T21:30:00-07:00 affichera un décalage de -07:00 heures.
  • Timezone Offset : choisissez un fuseau horaire pour calculer le décalage UTC. Ce calcul tient compte de l’heure d’été qui peut éventuellement être mise en œuvre à certaines dates dans certains fuseaux horaires.
  • Lat/Long Offset : spécifiez un emplacement à partir d’une chaîne de latitude et de longitude séparées par une virgule (,). L’heure d’été sera incluse dans le calcul du décalage. Par exemple, 47.650499,-122.350070 correspond aux régions America/Los_Angeles et donnerait -08:00 en hiver et -07:00 en été.
  • Custom Offset : définissez un décalage personnalisé au format ±HH:mm. Par exemple : plus huit heures et demie : +08:30

Renvois du module Parse Date/Time

Si la chaîne d’entrée est analysée avec succès, le module renvoie un objet Date/Time structuré.

Module Round Date/Time

Le module Round Date/Time renvoie le début ou la fin d’une unité de temps spécifiée pour un objet Date/Time structuré donné.

Champs du module Round Date/Time

• Start/End : arrondit l’entrée au début ou à la fin de l’unité de temps spécifiée.
  • Start : arrondi au début d’une unité de temps. Par exemple, 8 h 15 s’affichera sous la forme 8.00am.
  • End : arrondi à la fin d’une unité de temps. Par exemple, 8 h 15 s’affichera sous la forme 8.59am.
• Date : une entrée obligatoire devant être arrondie à l’unité supérieure ou inférieure spécifiée.. L’entrée peut être une chaîne au format ISO-8601, un horodatage Unix ou le résultat structuré d’un objet Date/Time d’un autre module Date/Time.
• Unit of Time : l’unité de temps dans laquelle vous souhaitez arrondir à l’unité supérieure ou inférieure. Les options disponibles sont les suivantes :
  • Year
  • Quarter
  • Month
  • Week
  • Day
  • Hour
  • Minute

First Day of Week

Le premier jour de la semaine peut varier d’un pays à l’autre, de sorte que lorsque l’unité de temps sélectionnée est week, cette option vous permet de définir le jour considéré comme le début de la semaine.

Renvois du module Round Date/Time

Si la chaîne d’entrée est analysée avec succès, le module renvoie un objet Date/Time structuré.