Fonctions Date et heure

Vous trouverez ci-dessous une liste des fonctions de formatage de la date et de l’heure dans les scénarios AlayaConnector.

formatDate (date; format; [timezone])

Lorsque les utilisateurs disposent d’une valeur date dont ils souhaitent convertir le format en une valeur texte telle que 12-10-2019 20:30 ou Aug 18, 2019 10:00 AM, les paramètres suivants peuvent être utilisés.

Paramètres

La deuxième colonne des paramètres indique le type attendu. Une coercition de type sera appliquée si un type différent est fourni.

	Type	Justification
date	Date	La valeur Date sera convertie en valeur Texte.
format	Texte	Format spécifiée à l'aide de jetons pour le formatage de la date et de l'heure. Exemple : DD.MM.YYYY HH:mm
fuseau horaire	Texte	Facultatif. Attention, tous les fuseaux horaires ne sont pas reconnus. Consultez votre gestionnaire de compte pour en savoir plus. Si ce champ est omis, le fuseau horaire défini dans les paramètres du profil de l’utilisateur sera appliqué. Vous trouverez les paramètres sous Options de fuseau horaire > Scénarios > Organisation détentrice du scénario Exemples : Europe/Prague, UTC

Retour de la valeur et du type

Représentation textuelle de la valeur Date donnée selon le format et le fuseau horaire spécifiés. Le type est Texte.

parseDate (text; format; [timezone])

Lorsque les utilisateurs disposent d’une valeur textuelle représentant une date (par exemple 12-10-2019 20:30 ou Aug 18, 2019 10:00 AM) et qu’ils souhaitent la convertir (l’analyser) en date (représentation binaire lisible par une machine), ils peuvent utiliser cette fonction.

Paramètres

La deuxième colonne des paramètres indique le type attendu. Une coercition de type sera appliquée si un type différent est fourni.

	Type	Justification
texte	Texte	Valeur textuelle à convertir en valeur Date.
format	Texte	Format spécifié à l'aide de jetons pour le formatage de la date et de l'heure. Exemple : DD.MM.YYYY HH:mm
fuseau horaire	Texte	Facultatif. Attention, tous les fuseaux horaires ne sont pas reconnus. Consultez votre gestionnaire de compte pour en savoir plus. Si ce champ est omis, le fuseau horaire défini dans les paramètres du profil de l’utilisateur sera appliqué. Vous trouverez les paramètres sous Options de fuseau horaire > Scénarios > Organisation détentrice du scénario Exemples : Europe/Prague, UTC

 

Retour de la valeur et du type

Représentation en date de la valeur Date donnée selon le format et le fuseau horaire spécifiés. Le type est Date.

addDays (date; number)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné de jours à une date. Pour soustraire des jours, saisissez un nombre négatif.

addDays(2016-12-08T15:55:57.536Z;2)
= 2016-12-10T15:55:57.536Z

addDays(2016-12-08T15:55:57.536Z;-2)
= 2016-12-6T15:55:57.536Z

addHours (date; number)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné d’heures à une date. Pour soustraire des heures, saisir un nombre négatif.

addHours(2016-12-08T15:55:57.536Z;2)
= 2016-12-08T17:55:57.536Z

addHours(2016-12-08T15:55:57.536Z;-2)
= 2016-12-08T13:55:57.536Z

addMinutes (date; number)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné de minutes à une date. Pour soustraire des minutes, saisir un nombre négatif.

addMinutes(2016-12-08T15:55:57.536Z;2)
= 2016-12-08T15:57:57.536Z

addMinutes(2016-12-08T15:55:57.536Z;-2)
= 2016-12-08T15:53:57.536Z

addMonths (date; number)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné de mois à une date. Pour soustraire des mois, saisir un nombre négatif.

addMonths(2016-08-08T15:55:57.536Z;2)
= 2016-10-08T15:55:57.536Z

addMonths(2016-08-08T15:55:57.536Z;-2)
= 2016-06-08T15:55:57.536Z

addSeconds (date; number)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné de secondes à une date. Pour soustraire des secondes, saisir un nombre négatif.

addSeconds(2016-12-08T15:55:57.536Z;2)
= 2016-12-08T15:55:59.536Z

addSeconds(2016-12-08T15:55:57.536Z;-2)
= 2016-12-08T15:55:55.536Z

addYears (date;years)

Cette fonction renvoie une nouvelle date résultant de l’ajout d’un nombre donné d’années à une date. Pour soustraire des années, saisir un nombre négatif.

addYears(2016-08-08T15:55:57.536Z;2)
= 2018-08-08T15:55:57.536Z

addYears(2016-08-08T15:55:57.536Z;-2)
= 2014-08-08T15:55:57.536Z

setSecond (date; number)

Cette fonction renvoie une nouvelle date avec les secondes spécifiées dans les paramètres et accepte les nombres de 0 à 59. Si un nombre sort de cet intervalle, la date sera affichée avec les secondes de la ou des minutes précédentes ou suivantes.

setSecond(2015-10-07T11:36:39.138Z;10)
= 2015-10-07T11:36:10.138Z

setSecond(2015-10-07T11:36:39.138Z;61)
= 2015-10-07T11:37:01.138Z

setMinute (date; number)

Cette fonction renvoie une nouvelle date avec les minutes spécifiées dans les paramètres et accepte les nombres de 0 à 59. Si un nombre sort de cet intervalle, la date sera affichée avec les minutes de la ou des heures précédentes ou suivantes.

setMinute(2015-10-07T11:36:39.138Z;10)
= 2015-10-07T11:10:39.138Z

setMinute(2015-10-07T11:36:39.138Z;61)
= 2015-10-07T12:01:39.138Z

setHour (date; number)

Cette fonction renvoie une nouvelle date avec l’heure spécifiée dans les paramètres et accepte les nombres de 0 à 23. Si un nombre sort de cet intervalle, la date sera affichée avec l’heure du ou des jours précédents ou suivante.

setHour(2015-08-07T11:36:39.138Z;6)
= 2015-08-07T06:36:39.138Z

setHour(2015-08-07T11:36:39.138Z;-6)
= 2015-08-06T18:36:39.138Z

setDay (date; le nom de la journée est en anglais)

Cette fonction renvoie une nouvelle date avec le jour spécifié dans les paramètres. Peut être utilisé pour configurer le jour de la semaine où dimanche équivaut à 1 et samedi à 7. Si la valeur donnée se trouve entre 1 et 7, la date donnée se situe dans la semaine en cours (dimanche au samedi). Si un nombre sort de l’intervalle, le jour de la ou des semaines précédentes ou suivantes sera renvoyé.

setDay(2018-06-27T11:36:39.138Z;monday)
= 2018-06-25T11:36:39.138Z

setDay(2018-06-27T11:36:39.138Z;1)
= 2018-06-24T11:36:39.138Z

setDay(2018-06-27T11:36:39.138Z;7)
= 2018-06-30T11:36:39.138Z

setDate (date; number)

Cette fonction renvoie une nouvelle date avec le jour du mois spécifié dans les paramètres et accepte les nombres de 0 à 31. Si un nombre sort de l’intervalle, le jour du ou des mois précédents ou suivants sera renvoyé.

setDate(2015-08-07T11:36:39.138Z;5)
= 2015-08-05T11:36:39.138Z

setDate(2015-08-07T11:36:39.138Z;32)
= 2015-09-01T11:36:39.138Z

setMonth (date; le numéro/nom du mois est en anglais)

Cette fonction renvoie une nouvelle date avec le mois spécifié dans les paramètres et accepte les nombres de 1 à 12. Si un nombre sort de l’intervalle, le mois de la ou des années précédentes ou suivantes sera renvoyé.

setMonth(2015-08-07T11:36:39.138Z;5)
= 2015-05-07T11:36:39.138Z

setMonth(2015-08-07T11:36:39.138Z;17)
= 2016-05-07T11:36:39.138Z

setMonth(2015-08-07T11:36:39.138Z;january)
= 2015-01-07T12:36:39.138Z

setYear (date; number)

Cette fonction renvoie une nouvelle date avec l’année spécifiée dans les paramètres.

setYear(2015-08-07T11:36:39.138Z;2017)
= 2017-08-07T11:36:39.138Z

D’autres instructions seront bientôt disponibles concernant le calcul des dates et de l’heure dans Alaya Connector.