Funktionen für Datum/Uhrzeit
- Themen:
- Personalisierung
Erstellt für:
- Experte
- Entwickler
Mit Datums- und Uhrzeitfunktionen können Datums- und Uhrzeitvorgänge für Werte in Journey Optimizer durchgeführt werden.
Tage hinzufügen
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
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
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
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
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
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
Die age-Funktion wird verwendet, um das Alter zu einem bestimmten Datum abzurufen.
Syntax
{%= age(datetime) %}
Alter in Tagen
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
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
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
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
Die currentTimeInMillis-Funktion wird verwendet, um die aktuelle Zeit in Epochenmillisekunden abzurufen.
Syntax
{%= currentTimeInMillis() %}
Datumsunterschied
Die dateDiff-Funktion wird verwendet, um die Differenz zwischen zwei Daten als Anzahl von Tagen abzurufen.
Syntax
{%= dateDiff(datetime,datetime) %}
Tag des Monats
Die Funktion dayOfWeek 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
Die dayOfWeek-Funktion wird zum Abrufen des Wochentags verwendet.
Syntax
{%= dayOfWeek(datetime) %}
Tag des Jahres
Die dayOfYear-Funktion wird zum Abrufen des Tages des Jahres verwendet.
Syntax
{%= dayOfYear(datetime) %}
Unterschied in Sekunden
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
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
Die Funktion extractMinutes extrahiert die Minutenkomponente aus einem bestimmten Zeitstempel.
Syntax
{%= extractMinutes(date) %}
- Eingabe:
{%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%} - Ausgabe:
19
Monate extrahieren
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
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
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.
NOTEBeispiel
Der folgende Vorgang gibt das Datum in diesem Format zurück: MM/TT/JJ.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Formatieren des Datums mit Gebietsschema-Unterstützung
Die Funktion formatDate wird verwendet, um einen Datums-/Uhrzeitwert in die entsprechende sprachabhängige Darstellung zu formatieren, 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.
NOTEBeispiel
Der folgende Vorgang gibt das Datum in diesem Format zurück: MM/TT/JJ und Gebietsschema FRANKREICH.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/DD/YY", "fr_FR") %}
CurrentZonedDateTime abrufen
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
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
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
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
Die setDays-Funktion wird verwendet, um den Tag des Monats für die Datums-/Uhrzeitangabe festzulegen.
Syntax
{%= setDays(datetime, day) %}
Stunden festlegen
Die setHours-Funktion wird verwendet, um die Stunde der Datums-/Uhrzeitangabe festzulegen.
Syntax
{%= setHours(datetime, hour) %}
Zu Uhrzeit-/Datumsangabe
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
Die toUTC-Funktion wird verwendet, um eine Datums-/Uhrzeitangabe in UTC zu konvertieren.
Syntax
{%= toUTC(datetime) %}
Auf Tagesanfang kürzen
Die Funktion truncateToStartOfDay wird verwendet, um eine bestimmte Uhrzeit-/Datumsangabe zu ändern, indem sie 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
Die Funktion truncateToStartOfQuarter wird verwendet, um eine Uhrzeit-/Datumsangabe auf den ersten Tag des Quartals (z. B. 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
Die Funktion truncateToStartOfWeek ändert eine bestimmte Uhrzeit-/Datumsangabe, indem sie 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
Die Funktion truncateToStartOfYear wird zur Änderung einer bestimmten Uhrzeit-/Datumsangabe verwendet, indem sie 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
Die Funktion weekOfYear wird verwendet, um die Woche des Jahres abzurufen.
Syntax
{%= weekOfYear(datetime) %}
Jahresdifferenz
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