Fonctions de date/heure
Créé pour :
- Expérimenté
- Développeur
Les fonctions de date et d’heure sont utilisées pour effectuer des opérations de date et d’heure sur des valeurs dans Journey Optimizer.
Ajouter des jours
La fonction addDays ajuste une date donnée d’un nombre de jours spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addDays(date, number) %}
- Entrée :
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - Sortie :
2024-11-11T17:19:51Z
Ajouter des heures
La fonction addHours ajuste une date donnée d’un nombre d’heures spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addHours(date, number) %}
- Entrée :
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - Sortie :
2024-11-01T18:19:51Z
Ajouter des minutes
La fonction addMinutes ajuste une date donnée d’un nombre de minutes spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addMinutes(date, number) %}
- Entrée :
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - Sortie :
2024-11-01T18:09:51Z
Ajouter des mois
La fonction addMonths ajuste une date donnée d’un nombre de mois spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addMonths(date, number) %}
- Entrée :
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Sortie :
2025-01-01T17:19:51Z
Ajouter des secondes
La fonction addSeconds ajuste une date donnée d’un nombre de secondes spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addSeconds(date, number) %}
- Entrée :
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Sortie :
2024-11-01T17:20:01Z
Ajouter des années
La fonction addYears ajuste une date donnée d’un nombre d’années spécifié, en utilisant des valeurs positives pour incrémenter et des valeurs négatives pour diminuer.
Syntaxe
{%= addYears(date, number) %}
- Entrée :
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Sortie :
2026-11-01T17:19:51Z
Ancienneté
La fonction age sert à récupérer l’âge à partir d’une date donnée.
Syntaxe
{%= age(datetime) %}
Ancienneté en jours
La fonction ageInDays calcule l’ancienneté d’une date donnée en jours, c’est-à-dire le nombre de jours écoulés entre la date donnée et la date actuelle, négatif pour les dates futures et positif pour les dates passées.
Syntaxe
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 (Asie/Calcutta)
- Entrée :
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - Sortie :
5
Ancienneté en mois
La fonction ageInMonths calcule l’ancienneté d’une date donnée en mois, c’est-à-dire le nombre de mois écoulés entre la date donnée et la date actuelle, négatif pour les dates futures et positif pour les dates passées.
Syntaxe
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30(Asie/Calcutta)
- Entrée :
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Sortie :
12
Comparer les dates
La fonction compareDates compare la première date d’entrée à l’autre. Renvoie 0 si la valeur date1 est égale à date2, -1 si la valeur date1 est antérieure à date2 et 1 si la valeur date1 est postérieure à date2.
Syntaxe
{%= compareDates(date1, date2) %}
- Entrée :
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Sortie :
-1
Convertir ZonedDateTime
La fonction convertZonedDateTime convertit une date-heure en un fuseau horaire donné.
Syntaxe
{%= convertZonedDateTime(dateTime, timezone) %}
- Entrée :
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Sortie :
2019-02-19T11:39+03:30[Asia/Tehran]
Heure actuelle en millisecondes
La fonction currentTimeInMillis est utilisée pour récupérer l’heure actuelle en millisecondes Epoch.
Syntaxe
{%= currentTimeInMillis() %}
Différence de date
La fonction dateDiff sert à récupérer la différence entre deux dates en nombre de jours.
Syntaxe
{%= dateDiff(datetime,datetime) %}
Jour du mois
La fonction dayOfWeek renvoie le nombre représentant le jour du mois.
Syntaxe
{%= dayOfMonth(datetime) %}
- Entrée :
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Sortie :
5
Jour de la semaine
La fonction dayOfWeek est utilisée pour récupérer le jour de la semaine.
Syntaxe
{%= dayOfWeek(datetime) %}
Jour de l’année
La fonction dayOfYear est utilisée pour récupérer le jour de l’année.
Syntaxe
{%= dayOfYear(datetime) %}
Différence en secondes
La fonction diffInSeconds renvoie la différence entre deux dates en nombre de secondes.
Syntaxe
{%= diffInSeconds(endDate, startDate) %}
- Entrée :
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Sortie :
50
Extraire les heures
La fonction extractHours extrait le composant des heures d’un horodatage donné.
Syntaxe
{%= extractHours(date) %}
- Entrée :
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
17
Extraire les minutes
La fonction extractMinutes extrait le composant des minutes d’un horodatage donné.
Syntaxe
{%= extractMinutes(date) %}
- Entrée :
{%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
19
Extraire les mois
La fonction extractMonth extrait le composant des mois d’un horodatage donné.
Syntaxe
{%= extractMonths(date) %}
- Entrée :
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
11
Extraire les secondes
La fonction extractSeconds extrait le composant des secondes d’un horodatage donné.
Syntaxe
{%= extractSeconds(date) %}
- Entrée :
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
51
Mettre en forme la date
La fonction formatDate sert à formater une valeur de date et d’heure. Le format doit être un modèle Java DateTimeFormat valide.
Syntaxe
{%= formatDate(datetime, format) %}
Où la première chaîne correspond à l’attribut date et la seconde à la manière dont vous souhaitez que la date soit convertie et affichée.
NOTEExemple
L’opération suivante renvoie la date au format suivant : MM/JJ/AA.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Formater la date avec la prise en charge des paramètres régionaux
La fonction formatDate permet de formater une valeur d’heure et de date au format de la langue correspondante, c’est-à-dire dans le paramètre régional souhaité. Le format doit être un modèle Java DateTimeFormat valide.
Syntaxe
{%= formatDate(datetime, format, locale) %}
Lorsque la première chaîne correspond à l’attribut de date, la seconde valeur correspond à la manière dont vous souhaitez que la date soit convertie et affichée, tandis que la troisième valeur représente le paramètre régional au format chaîne.
NOTEExemple
L’opération ci-dessous renvoie la date au format suivant : MM/JJ/AA, dans le paramètre régional FRANCE.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/DD/YY", "fr_FR") %}
Obtenir la CurrentZonedDateTime
La fonction getCurrentZonedDateTime renvoie la date et l’heure actuelles avec les informations de fuseau horaire.
Syntaxe
{%= getCurrentZonedDateTime() %}
- Entrée :
{%= getCurrentZonedDateTime() %} - Sortie :
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
Différence en heures
La fonction diffInHours renvoie la différence entre deux dates en nombre d’heures.
Syntaxe
{%= diffInHours(endDate, startDate) %}
- Entrée :
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - Sortie :
10
Différence en minutes
La fonction diffInMinutes sert à renvoyer la différence entre deux dates en nombre de minutes.
Syntaxe
{%= diffInMinutes(endDate, startDate) %}
- Entrée :
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - Sortie :
60
Différence en mois
La fonction diffInMonths renvoie la différence entre deux dates en nombre de mois.
Syntaxe
{%= diffInMonths(endDate, startDate) %}
- Entrée :
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - Sortie :
3
Définir les jours
La fonction setDays sert à définir le jour du mois pour la valeur date-heure donnée.
Syntaxe
{%= setDays(datetime, day) %}
Définir des heures
La fonction setHours sert à définir l’heure de la valeur date-heure.
Syntaxe
{%= setHours(datetime, hour) %}
En date/heure
La fonction ToDateTime convertit une chaîne en date. Elle renvoie la date de l’époque comme sortie pour une entrée non valide.
Syntaxe
{%= toDateTime(string, string) %}
- Entrée :
{%=toDateTime("2024-11-01T17:19:51Z")%} - Sortie :
2024-11-01T17:19:51Z
En UTC
La fonction toUTC est utilisée pour convertir une heure en UTC.
Syntaxe
{%= toUTC(datetime) %}
Tronquer au début de la journée
La fonction truncateToStartOfDay modifie une date-heure donnée en la définissant sur le début de la journée et sur 00:00.
Syntaxe
{%= truncateToStartOfDay(date) %}
- Entrée :
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - Sortie :
2024-11-01T00:00Z
truncateToStartOfQuarter
La fonction truncateToStartOfQuarter tronque une date-heure au premier jour de son trimestre (par exemple, 1er janvier, 1er avril, 1er juillet, 1er octobre) à 00:00.
Syntaxe
{%= truncateToStartOfQuarter(dateTime) %}
- Entrée :
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
2024-10-01T00:00Z
truncateToStartOfWeek
La fonction truncateToStartOfWeek modifie une date-heure donnée en la définissant sur le début de la semaine (lundi à 00:00).
Syntaxe
{%= truncateToStartOfWeek(dateTime) %}
- Entrée :
truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - Sortie :
2024-11-18T00:00Z // monday
truncateToStartOfYear
La fonction truncateToStartOfYear modifie une date-heure donnée en la tronquant au premier jour de l’année (1er janvier) à 00:00.
Syntaxe
{%= truncateToStartOfYear(dateTime) %}
- Entrée :
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - Sortie :
2024-01-01T00:00Z
Semaine de l’année
La fonction weekOfYear est utilisée pour récupérer la semaine de l’année.
Syntaxe
{%= weekOfYear(datetime) %}
Différence en années
La fonction diffInYears sert à renvoyer la différence entre deux dates en nombre d’années.
Syntaxe
{%= diffInYears(endDate, startDate) %}: int
- Entrée :
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - Sortie :
5