Fonctions de date date-functions

Les fonctions de date vous permettent de manipuler et d’utiliser des valeurs de date et d’heure dans vos expressions de parcours. Ces fonctions sont essentielles pour les conditions temporelles, la planification et les calculs temporels de vos parcours client.

Utilisez des fonctions de date lorsque vous devez :

Les fonctions de date fournissent un contrôle précis sur la logique temporelle, ce qui vous permet de créer des conditions et des chemins de parcours sensibles au temps qui répondent à des périodes et à des plannings spécifiques.

NOTE
Les fonctions de cette page sont disponibles dans les expressions de parcours. Certaines fonctions telles que now() ne sont pas disponibles dans l’éditeur de personnalisation du contenu des e-mails. ​ En savoir plus ​

currentTimeInMillis currentTimeInMillis

Renvoie l’heure actuelle en millisecondes Epoch.

Syntaxe
currentTimeInMillis()
Paramètres
Cette fonction n’utilise aucun paramètre.
Signatures et type renvoyé

currentTimeInMillis()

Renvoie un entier.

Exemples

currentTimeInMillis()

Renvoie « 1544712617131 ».

inLastDays inLastDays

Renvoie true si une valeur dateTime donnée se situe entre maintenant et maintenant - jours delta.

Syntaxe
inLastDays(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inLastDays(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inLastHours inLastHours

Renvoie true si l’heure donnée est comprise entre maintenant et maintenant - delta hours.

Syntaxe
inLastHours(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inLastHours(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inLastHours(@event{MyEvent.timestamp}, 4)

Renvoie true.

inLastMonths inLastMonths

Renvoie « true » si une date ou une dateTime donnée se situe entre maintenant et maintenant - mois delta.

Syntaxe
inLastMonths(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inLastMonths(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inLastYears inLastYears

Renvoie « true » si une date ou une dateTime donnée se situe entre maintenant et maintenant - années delta.

Syntaxe
inLastYears(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inLastYears(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inNextDays inNextDays

Renvoie « true » si une date ou dateTime donnée se situe entre maintenant et maintenant + delta days.

Syntaxe
inNextDays(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inNextDays(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inNextHours inNextHours

Renvoie true si une date ou une dateTime donnée est comprise entre maintenant et maintenant + delta hours.

Syntaxe
inNextHours(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inNextHours(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie true.

inNextMonths inNextMonths

Renvoie « true » si une date ou une dateTime donnée se situe entre maintenant et maintenant + delta months.

Syntaxe
inNextMonths(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inNextMonths(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)

Renvoie true.

inNextYears inNextYears

Renvoie « true » si une date ou une dateTime donnée se situe entre maintenant et maintenant + années delta.

Syntaxe
inNextYears(<dateTime>,<delta>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
date-heure dateTime
delta nombre entier
Signatures et type renvoyé

inNextYears(<dateTime>,<integer>)

Renvoie une valeur booléenne.

Exemples

inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)

Renvoie true.

now now

Renvoie la date actuelle au format date et heure. Pour plus d’informations sur les types de données, consultez cette page.

NOTE
Cette fonction n’est disponible que dans les expressions de parcours. Pour la personnalisation des e-mails et d’autres contenus, utilisez plutôt getCurrentZonedDateTime(). ​ En savoir plus ​
Syntaxe
now(<parameter>)
Paramètres
table 0-row-2 1-row-2
Paramètre Description
chaîne Identifiant du fuseau horaire (optionnel)
Signatures et type renvoyé

now()

now("<timeZone id>")

Renvoie une valeur dateTime.

Exemples

now()

Renvoie 2023-06-:30Z.

toString(now())

Renvoie « 2023-06-03T06 :30Z »

now("Europe/Paris")

Renvoie 2023-06-:30+02:00.

nowWithDelta nowWithDelta

Renvoie la date/heure actuelle avec un décalage. Si un ID de fuseau horaire est spécifié, le décalage de fuseau horaire est appliqué. Pour plus d’informations sur les types de données, consultez cette page.

Syntaxe
nowWithDelta(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre Description
delta valeur entière positive ou négative
partie de date années, mois, jours, heures, minutes ou secondes sous forme de chaîne
id de fuseau horaire représentation sous forme de chaîne de la valeur du fuseau horaire. Pour plus d’informations, voir Types de données. L’ID du fuseau horaire doit être une constante de chaîne. Il ne peut pas s’agir d’une référence de champ ou d’une expression.
Signatures et type renvoyé

nowWithDelta(<delta>,<date part>

nowWithDelta(<delta>,<date part>,"<timeZone id>")

Renvoie une valeur dateTime.

Exemples

nowWithDelta(-2, "hours")

nowWithDelta(-2, "hours", "Europe/Paris")

Renvoie une valeur dateTime il y a exactement 2 heures.

setHours setHours

Définit les heures d’une date/heure ou d’une date/heure uniquement. Par exemple, si vous souhaitez attendre jusqu’à une certaine heure demain, vous pouvez forcer l’heure.

Syntaxe
setHours(<parameter>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre Type
date-heure dateTime
heure de la date sans tenir compte du fuseau horaire dateTimeOnly
heures nombre entier
Signatures et type renvoyé

setHours(<dateTime>,<hours>)

Renvoie une valeur datetime.

setHours(<dateTimeOnly>,<hours>)

Renvoie une valeur datetime sans tenir compte du fuseau horaire.

Exemples

setHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Renvoie 2023-12-:11:00Z.

setHours(nowWithDelta(1, "days"), 20)

Retourne demain à 20h:XY, XY étant le procès-verbal au moment de l’évaluation de l’heure actuelle. Si l’évaluation a lieu à 2:45 h, l’heure renvoyée sera 20 :45.

setDays setDays

Définit le jour d’une date/heure ou d’une date/heure uniquement. Par exemple, si vous souhaitez attendre jusqu’à un certain jour du mois, vous pouvez forcer le jour.

Syntaxe
setDays(<parameter>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre Type
date-heure dateTime
heure de la date sans tenir compte du fuseau horaire dateTimeOnly
jours nombre entier
Signatures et type renvoyé

setDays(<dateTime>,<days>)

Renvoie une valeur datetime.

setDays(<dateTimeOnly>,<days>)

Renvoie une valeur datetime sans tenir compte du fuseau horaire.

Exemples

setDays(toDateTime('2023-12-12T01:11:00Z'), 25)

Renvoie 2023-12-:11:00Z.

setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)

updateTimeZone updateTimeZone

Renvoie une nouvelle date et une nouvelle heure, avec un nouveau fuseau horaire sur le même instant.

Syntaxe
updateTimeZone(<parameters>)
Paramètres
  • id de fuseau horaire : chaîne
  • dateTime
Signature et type renvoyé

updateTimeZone(<dateTime>,<timeZone id>)

Renvoie une valeur datetime.

Exemples

updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))

Renvoie 2023-08-:15:30.123+02:00.

updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")

Si la valeur du champ d’horodatage est 2021-11-16T16:55:12.939318+01:00, la fonction renvoie 2021-11-17T02:55:12.942115+11:00.

recommendation-more-help
journey-optimizer-help