Fonctions de date et d’heure dans Adobe Workfront Fusion

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Pour plus d’informations sur ce tableau, consultez Conditions d’accès requises dans la documentation Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez les Adobe Workfront Fusion licences.

Variables

maintenant

horodatage

Fonctions

addSeconds (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de secondes à une date. Pour soustraire des secondes, saisissez un nombre négatif.

addMinutes (date; nombre) addminutes-date-number

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de minutes à une date. Pour soustraire les minutes, saisissez un nombre négatif.

addHours (date; nombre) addhours-date-number

Renvoie une nouvelle date suite à l’ajout d’un nombre donné d’heures à une date. Pour soustraire les heures, saisissez un nombre négatif.

addDays (date; nombre) adddays-date-number

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de jours à une date. Pour soustraire des jours, saisissez un nombre négatif.

addMonths (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de mois à une date. Pour soustraire des mois, saisissez un nombre négatif.

addYears (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné d’années à une date. Pour soustraire des années, saisissez un nombre négatif.

setSecond (date; nombre)

Cette fonction renvoie une nouvelle date avec les secondes indiquées dans les paramètres.

Indiquez un nombre compris entre 0 et 59. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une seconde à partir de la minute précédente (pour un nombre négatif) ou de la minute suivante (pour un nombre positif).

Si vous devez indiquer un nombre en dehors de la plage, nous vous recommandons d’utiliser addSeconds, comme décrit ci-dessus dans la section addSeconds (date; nombre).

setMinute (date; nombre)

Cette fonction renvoie une nouvelle date avec les minutes indiquées dans les paramètres.

Indiquez un nombre compris entre 0 et 59. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une minute par rapport à l’heure précédente (pour un nombre négatif) ou à l’heure suivante (pour un nombre positif).

Si vous devez indiquer un nombre en dehors de la plage, nous vous recommandons d’utiliser addMinutes, comme décrit ci-dessus dans la section addMinutes (date; nombre).

setHour (date; nombre)

Cette fonction renvoie une nouvelle date avec l’heure indiquée dans les paramètres.

Indiquez un nombre compris entre 0 et 23. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une heure à partir du jour précédent (pour un nombre négatif) ou du jour suivant (pour un nombre positif).

Si vous devez spécifier un nombre en dehors de la plage, nous vous recommandons d’utiliser addHours, comme décrit ci-dessus dans la section addHours (date; nombre).

setDay (date; nombre/nom du jour en anglais)

Cette fonction renvoie une nouvelle date avec le jour spécifié dans les paramètres.

Vous pouvez utiliser cette fonction pour définir le jour de la semaine, avec le dimanche comme 1 et le samedi comme 7. Si vous indiquez un nombre compris entre 1 et 7, la date obtenue est comprise dans la semaine en cours (du dimanche au samedi). Si le nombre ne figure pas dans cette plage, la fonction renvoie un jour de la semaine précédente (pour un nombre négatif) ou de la semaine suivante (pour un nombre positif).

Si vous devez spécifier un nombre en dehors de la plage, nous vous recommandons d’utiliser addDays, comme décrit ci-dessus dans la section addDays (date; nombre).

setDate (date; nombre)

Cette fonction renvoie une nouvelle date avec le jour du mois spécifié dans les paramètres.

Indiquez un nombre compris entre 1 et 31. Si le nombre se trouve en dehors de cette plage, la fonction renvoie un jour à partir du mois précédent (pour un nombre négatif) ou du mois suivant (pour un nombre positif).

setMonth (date; nombre/nom du mois en anglais)

Cette fonction renvoie une nouvelle date avec le mois spécifié dans les paramètres.

Indiquez un nombre compris entre 1 et 12. Si le nombre ne figure pas dans cette plage, la fonction renvoie le mois de l’année précédente (pour un nombre négatif) ou de l’année suivante (pour un nombre positif).

setYear (date; nombre)

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

formatDate (date; format; [fuseau horaire])

Utilisez cette fonction lorsque vous disposez d’une valeur Date, telle que 12-10-2021 20:30, que vous souhaitez formater en tant que valeur Texte, par exemple Dec 10, 2021 8:30 PM.

Cela s’avère utile, par exemple, lorsque vous devez modifier le format de date d’une application ou d’un service web vers celui d’une application ou d’un service web connecté dans le même scénario.

Pour plus d’informations, voir Date et Texte dans l’article Types de données d’élément dans Adobe Workfront Fusion.

Paramètres

Si un autre type est fourni, la coercition de type est appliquée. Pour plus d’informations, voir Coercition de type dans Adobe Workfront Fusion.

Valeur et type de renvoi

La fonction formatDate renvoie une représentation textuelle de la valeur Date donnée en fonction du format et du fuseau horaire spécifiés. Le type de données est Texte.

INFO

Exemples : le scénario et le fuseau horaire web ont tous deux été définis sur Europe/Prague dans ces exemples.

• formatDate(1. Date created;MM/DD/YYYY)

  Renvoie 10/01/2018

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  Renvoie 2018-10-01 09:32 AM

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  Renvoie 01.10.2018 07:32

• formatDate(now;DD.MM.YYYY HH:mm)

  Renvoie 19.03.2019 15:30

parseDate (texte; format; [fuseau horaire])

Utilisez cette fonction lorsque vous disposez d’une valeur Texte représentant une date (telle que 12-10-2019 20:30 ou Aug 18, 2019 10:00 AM) et que vous souhaitez convertir (parse) en une valeur Date (représentation binaire lisible par un ordinateur). Pour plus d’informations, voir Date et Texte dans l’article Types de données d’élément dans Adobe Workfront Fusion.

Paramètres

La seconde colonne indique le type attendu. Si un autre type est fourni, la coercition de type est appliquée. Pour plus d’informations, voir Coercition de type dans Adobe Workfront Fusion.

Si un autre type est fourni, la coercition de type est appliquée. Pour plus d’informations, voir Coercition de type dans Adobe Workfront Fusion.

Valeur et type de renvoi

Cette fonction convertit une chaîne de texte en date, selon le format et le fuseau horaire indiqués. Le type de données de la valeur est Date.

dateDifference (Date1; Date2; unité)

Renvoie un nombre représentant la différence entre deux dates, exprimée dans l’unité spécifiée.

Date2 est soustraite de Date1.

Utilisez l’une des valeurs d’heure suivantes pour la paramètre unit :

Si aucune unité n’est spécifiée, la fonction renvoie la différence en millisecondes.

Exemples supplémentaires

Comment calculer le n-ième jour de la semaine dans le mois

Cette section est adaptée à Workfront Fusion. Elle est tirée de la page web Exceljet qui explique comment obtenir le n-ième jour de la semaine en un mois.

Si vous devez calculer une date correspondant au n-ième jour de la semaine dans le mois (par exemple, premier mardi, troisième vendredi, etc.), vous pouvez utiliser la formule suivante :

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

La formule contient les éléments suivants :

Si vous ne souhaitez calculer qu’un seul cas spécifique, par exemple tous les deuxièmes mercredis, vous pouvez remplacer les éléments 1.n et 2.dow dans la formule avec les nombres correspondants. Pour le deuxième mercredi du mois en cours, vous utiliserez les valeurs suivantes :

Explication :

Comment calculer les jours entre les dates

Une possibilité consiste à utiliser l’expression suivante :

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

Comment calculer le dernier jour/la dernière milliseconde du mois

Lorsque vous spécifiez une période, par exemple dans un module de recherche, si la période s’étend sur tout le mois précédent sous la forme d’un intervalle fermé (l’intervalle qui inclut ses deux points limites), vous devez calculer le dernier jour du mois.

2019-09-01 ≤ D ≤ 2019-09-30

La formule ci-dessous présente une méthode de calcul du dernier jour du mois précédent :

{{addDays(setDate(now; 1); -1)}}

Dans certains cas, vous devez calculer non seulement le dernier jour du mois, mais aussi sa dernière milliseconde :

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999Z

Cette formule présente un moyen de calculer la dernière milliseconde du mois précédent :

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

Si vous avez besoin que le résultat utilise votre paramètre de fuseau horaire, omettez l’argument UTC :

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

Cependant, il est préférable d’utiliser l’intervalle à demi-ouverture à la place (l’intervalle qui exclut l’un de ses points limites), en précisant plutôt le premier jour du mois suivant et en remplaçant l’opérateur « inférieur ou égal à » par « inférieur à » comme suit :

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z