Fonctions de date et d’heure dans Adobe Workfront Fusion

Conditions d’accès

Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :

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

now

timestamp

Fonctions

addSeconds (date ; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de secondes à une date. Pour soustraire les 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 d’heures donné à 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 les 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 les mois, saisissez un nombre négatif.

addYears (date ; nombre)

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

setSecond (date ; nombre)

Cette fonction renvoie une nouvelle date avec les secondes spécifié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 spécifié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 l’heure précédente (pour un nombre négatif) ou de l’heure suivante (pour un nombre positif).

Si vous devez spécifier 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 spécifié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 mettre en forme en tant que valeur Texte, par exemple Dec 10, 2021 8:30 PM.

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

Pour plus d’informations, consultez les sections 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, consultez la section 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 (text; format; [timezone])

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 (analyser) en une valeur Date (représentation lisible par un ordinateur binaire). 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, consultez la section 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 spécifié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 le paramètre unit :

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

Exemples supplémentaires

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

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

Si vous devez calculer une date correspondant au n-ième jour de la semaine dans un 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 un mercredi sur deux, 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 :

Calculer les jours entre les dates

Une possibilité consiste à utiliser l’expression suivante :

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

Calculer le dernier jour ou la dernière milliseconde du mois

Lorsque vous indiquez une pédiode, 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 les 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 littéralement 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