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 :
- Obtenez l’heure ou la date actuelles avec une gestion spécifique des fuseaux horaires (now, nowWithDelta, currentTimeInMillis)
- Vérifiez si une date se situe dans une plage de temps spécifique (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, inNextMonths, inNextYears)
- Modifier les composants de date et d’heure (setHours, setDays, updateTimeZone)
- Effectuer des calculs et des comparaisons temporels
- Conversion entre différents formats d’heure et représentations
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.
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.
currentTimeInMillis()currentTimeInMillis()
Renvoie un entier.
currentTimeInMillis()
Renvoie « 1544712617131 ».
inLastDays inLastDays
Renvoie true si une valeur dateTime donnée se situe entre maintenant et maintenant - jours delta.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inLastDays(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inLastHours(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inLastMonths(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inLastYears(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inNextDays(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inNextHours(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inNextMonths(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| date-heure | dateTime |
| delta | nombre entier |
inNextYears(<dateTime>,<integer>)
Renvoie une valeur booléenne.
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.
getCurrentZonedDateTime(). En savoir plus now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Paramètre | Description |
| chaîne | Identifiant du fuseau horaire (optionnel) |
now()
now("<timeZone id>")
Renvoie une valeur dateTime.
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.
nowWithDelta(<parameters>)| 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. |
nowWithDelta(<delta>,<date part>
nowWithDelta(<delta>,<date part>,"<timeZone id>")
Renvoie une valeur dateTime.
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.
setHours(<parameter>)| 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 |
setHours(<dateTime>,<hours>)
Renvoie une valeur datetime.
setHours(<dateTimeOnly>,<hours>)
Renvoie une valeur datetime sans tenir compte du fuseau horaire.
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.
setDays(<parameter>)| 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 |
setDays(<dateTime>,<days>)
Renvoie une valeur datetime.
setDays(<dateTimeOnly>,<days>)
Renvoie une valeur datetime sans tenir compte du fuseau horaire.
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.
updateTimeZone(<parameters>)- id de fuseau horaire : chaîne
- dateTime
updateTimeZone(<dateTime>,<timeZone id>)
Renvoie une valeur datetime.
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.