Funktionen für Datum/Uhrzeit date-time
Mit Datums- und Uhrzeitfunktionen können Datums- und Uhrzeitvorgänge für Werte in Journey Optimizer durchgeführt werden.
Tage hinzufügen add-days
Die Funktion addDays passt ein bestimmtes Datum um eine angegebene Anzahl von Tagen an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addDays(date, number) %}
- Eingabe:
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - Ausgabe:
2024-11-11T17:19:51Z
Stunden hinzufügen add-hours
Die Funktion addHours passt ein bestimmtes Datum um eine angegebene Anzahl von Stunden an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addHours(date, number) %}
- Eingabe:
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - Ausgabe:
2024-11-01T18:19:51Z
Minuten hinzufügen add-minutes
Die Funktion addMinutes passt ein bestimmtes Datum um eine angegebene Anzahl von Minuten an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addMinutes(date, number) %}
- Eingabe:
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - Ausgabe:
2024-11-01T18:09:51Z
Monate hinzufügen add-months
Die Funktion addMonths passt ein bestimmtes Datum um eine angegebene Anzahl von Monaten an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addMonths(date, number) %}
- Eingabe:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Ausgabe:
2025-01-01T17:19:51Z
Sekunden hinzufügen add-seconds
Die Funktion addSeconds passt ein bestimmtes Datum um eine angegebene Anzahl von Sekunden an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addSeconds(date, number) %}
- Eingabe:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Ausgabe:
2024-11-01T17:20:01Z
Jahre hinzufügen add-years
Die Funktion addYears passt ein bestimmtes Datum um eine angegebene Anzahl von Jahren an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.
Syntax
{%= addYears(date, number) %}
- Eingabe:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Ausgabe:
2026-11-01T17:19:51Z
Alter age
Die age-Funktion wird verwendet, um das Alter zu einem bestimmten Datum abzurufen.
Syntax
{%= age(datetime) %}
Alter in Tagen age-days
Die Funktion ageInDays berechnet das Alter eines bestimmten Datums in Tagen, d. h. die Anzahl der Tage, die zwischen dem angegebenen und dem aktuellen Datum verstrichen sind, wobei für zukünftige Datumswerte ein negativer und für vergangene Datumswerte ein positiver Wert gilt.
Syntax
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 (Asien/Kolkata)
- Eingabe:
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - Ausgabe:
5
Alter in Monaten age-months
Die Funktion ageInMonths berechnet das Alter eines bestimmten Datums in Monaten, d. h. die Anzahl der Monate, die zwischen dem angegebenen und dem aktuellen Datum verstrichen sind, wobei für zukünftige Datumswerte ein negativer und für vergangene Datumswerte ein positiver Wert gilt.
Syntax
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30(Asien/Kolkata)
- Eingabe:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Ausgabe:
12
Daten vergleichen compare-dates
Die Funktion compareDates vergleicht das erste Eingabedatum mit einem anderen. Gibt 0 zurück, wenn date1 gleich date2 ist, -1, wenn date1 vor date2 liegt, und 1, wenn date1 nach date2 liegt.
Syntax
{%= compareDates(date1, date2) %}
- Eingabe:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Ausgabe:
-1
Uhrzeit-/Datumsangabe in eine bestimmte Zeitzone umwandeln convert-zoned-date-time
Die Funktion convertZonedDateTime wandelt eine Datums-/Uhrzeitangabe in eine bestimmte Zeitzone um.
Syntax
{%= convertZonedDateTime(dateTime, timezone) %}
- Eingabe:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Ausgabe:
2019-02-19T11:39+03:30[Asia/Tehran]
Aktuelle Zeit in Millisekunden current-time
Die currentTimeInMillis-Funktion wird verwendet, um die aktuelle Zeit in Epochenmillisekunden abzurufen.
Syntax
{%= currentTimeInMillis() %}
Datumsunterschied date-diff
Die dateDiff-Funktion wird verwendet, um die Differenz zwischen zwei Daten als Anzahl von Tagen abzurufen.
Syntax
{%= dateDiff(datetime,datetime) %}
Tag des Monats day-month
Die Funktion dayOfMonth gibt die Zahl zurück, die dem Tag des Monats entspricht.
Syntax
{%= dayOfMonth(datetime) %}
- Eingabe:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Ausgabe:
5
Wochentag day-week
Die dayOfWeek-Funktion wird zum Abrufen des Wochentags verwendet.
Syntax
{%= dayOfWeek(datetime) %}
Tag des Jahres day-year
Die dayOfYear-Funktion wird zum Abrufen des Tages des Jahres verwendet.
Syntax
{%= dayOfYear(datetime) %}
Unterschied in Sekunden diff-seconds
Die Funktion diffInSeconds gibt den Unterschied zwischen zwei Daten in Form von Sekunden zurück.
Syntax
{%= diffInSeconds(endDate, startDate) %}
- Eingabe:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Ausgabe:
50
Stunden extrahieren extract-hours
Die Funktion extractHours extrahiert die Stundenkomponente aus einem bestimmten Zeitstempel.
Syntax
{%= extractHours(date) %}
- Eingabe:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
17
Minuten extrahieren extract-minutes
Die Funktion extractMinutes extrahiert die Minutenkomponente aus einem bestimmten Zeitstempel.
Syntax
{%= extractMinutes(date) %}
- Eingabe:
{%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
19
Monate extrahieren extract-months
Die Funktion extractMonth extrahiert die Monatskomponente aus einem bestimmten Zeitstempel.
Syntax
{%= extractMonths(date) %}
- Eingabe:
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
11
Sekunden extrahieren extract-seconds
Die Funktion extractSeconds extrahiert die Sekundenkomponente aus einem bestimmten Zeitstempel.
Syntax
{%= extractSeconds(date) %}
- Eingabe:
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
51
Datum formatieren format-date
Die formatDate-Funktion wird zum Formatieren eines Datums-/Uhrzeitwerts verwendet. Das Format sollte ein gültiges Java-DateTimeFormat-Muster sein.
Syntax
{%= formatDate(datetime, format) %}
Dabei ist die erste Zeichenfolge das Datumsattribut, und der zweite Wert gibt an, wie das Datum konvertiert und angezeigt werden soll.
Beispiel
Der folgende Vorgang gibt das Datum in diesem Format zurück: MM/TT/JJ.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Musterzeichen pattern-characters
Einige Musterbuchstaben sehen möglicherweise ähnlich aus, stellen jedoch unterschiedliche Konzepte dar.
2023-12-31T10:15:30Z)y2023Y2024 (seit 31. Dezember 2023 fällt in die erste Woche von 2024)MJan, January)12 oder Decm15d31D365Formatieren des Datums mit Gebietsschema-Unterstützung format-date-locale
Mit der Funktion formatDate kann ein Datums-/Uhrzeitwert in die entsprechende sprachabhängige Darstellung formatiert werden, d. h. in einem gewünschten Gebietsschema. Das Format sollte ein gültiges Java-DateTimeFormat-Muster sein.
Syntax
{%= formatDate(datetime, format, locale) %}
Dabei ist die erste Zeichenfolge das Datumsattribut, der zweite Wert ist die Art, wie das Datum konvertiert und angezeigt werden soll, und der dritte Wert stellt das Gebietsschema im Zeichenfolgenformat dar.
Beispiel
Der folgende Vorgang gibt das Datum in diesem Format zurück: TT/MM/JJ und Gebietsschema FRANKREICH.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}
CurrentZonedDateTime abrufen get-current-zoned-date-time
Die Funktion getCurrentZonedDateTime gibt das aktuelle Datum und die aktuelle Uhrzeit mit Zeitzoneninformationen zurück.
Syntax
{%= getCurrentZonedDateTime() %}
- Eingabe:
{%= getCurrentZonedDateTime() %} - Ausgabe:
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
Stundendifferenz hours-difference
Die Funktion diffInHours gibt den Unterschied zwischen zwei Daten in Form von Stunden zurück.
Syntax
{%= diffInHours(endDate, startDate) %}
- Eingabe:
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - Ausgabe:
10
Minutendifferenz diff-minutes
Die Funktion diffInMinutes gibt den Unterschied zwischen zwei Daten in Form von Minuten zurück.
Syntax
{%= diffInMinutes(endDate, startDate) %}
- Eingabe:
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - Ausgabe:
60
Monatsdifferenz months-difference
Die Funktion diffInMonths gibt den Unterschied zwischen zwei Daten in Form von Monaten zurück.
Syntax
{%= diffInMonths(endDate, startDate) %}
- Eingabe:
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - Ausgabe:
3
Tage festlegen set-days
Die setDays-Funktion wird verwendet, um den Tag des Monats für die Datums-/Uhrzeitangabe festzulegen.
Syntax
{%= setDays(datetime, day) %}
Stunden festlegen set-hours
Die setHours-Funktion wird verwendet, um die Stunde der Datums-/Uhrzeitangabe festzulegen.
Syntax
{%= setHours(datetime, hour) %}
Zu Uhrzeit-/Datumsangabe to-date-time
Die Funktion ToDateTime wandelt eine Zeichenfolge in ein Datum um. Bei einer ungültigen Eingabe wird als Ausgabe das Epochen-Datum zurückgegeben.
Syntax
{%= toDateTime(string, string) %}
- Eingabe:
{%=toDateTime("2024-11-01T17:19:51Z")%} - Ausgabe:
2024-11-01T17:19:51Z
In UTC to-utc
Die toUTC-Funktion wird verwendet, um eine Datums-/Uhrzeitangabe in UTC zu konvertieren.
Syntax
{%= toUTC(datetime) %}
Auf Tagesanfang kürzen truncate-day
Die Funktion truncateToStartOfDay wird verwendet, um eine bestimmte Uhrzeit-/Datumsangabe zu ändern, indem diese auf den Tagesanfang gesetzt wird, wobei die Zeit auf 00:00 Uhr eingestellt ist.
Syntax
{%= truncateToStartOfDay(date) %}
- Eingabe:
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - Ausgabe:
2024-11-01T00:00Z
truncateToStartOfQuarter truncate-quarter
Die Funktion truncateToStartOfQuarter wird verwendet, um eine Uhrzeit-/Datumsangabe auf den ersten Tag des Quartals (also 1. Januar, 1. April, 1. Juli, 1. Oktober) um 00:00 Uhr zu kürzen.
Syntax
{%= truncateToStartOfQuarter(dateTime) %}
- Eingabe:
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
2024-10-01T00:00Z
truncateToStartOfWeek truncate-week
Die Funktion truncateToStartOfWeek ändert eine bestimmte Uhrzeit-/Datumsangabe, indem diese auf den Wochenanfang (Montag um 00:00 Uhr) gesetzt wird.
Syntax
{%= truncateToStartOfWeek(dateTime) %}
- Eingabe:
{%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - Ausgabe:
2024-11-18T00:00Z // monday
truncateToStartOfYear truncate-year
Die Funktion truncateToStartOfYear wird verwendet, um eine bestimmte Uhrzeit-/Datumsangabe zu ändern, indem diese auf den ersten Tag des Jahres (1. Januar) um 00:00 Uhr gekürzt wird.
Syntax
{%= truncateToStartOfYear(dateTime) %}
- Eingabe:
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
2024-01-01T00:00Z
Woche des Jahres week-of-year
Die Funktion weekOfYear wird verwendet, um die Woche des Jahres abzurufen.
Syntax
{%= weekOfYear(datetime) %}
Jahresdifferenz diff-years
Die Funktion diffInYears wird verwendet, um den Unterschied zwischen zwei Daten in Form von Jahren zurückzugeben.
Syntax
{%= diffInYears(endDate, startDate) %}: int
- Eingabe:
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - Ausgabe:
5