Datumsfunktionen date-functions

currentTimeInMillis()

Gibt eine Ganzzahl zurück.

currentTimeInMillis()

Gibt „1544712617131“ zurück.

inLastDays(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inLastHours(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

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

Gibt „true“ zurück.

inLastMonths(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inLastYears(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inNextDays(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inNextHours(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inNextMonths(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

inNextYears(<dateTime>,<integer>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

now()

now("<timeZone id>")

Gibt einen Datum/Uhrzeit-Wert zurück.

now()

Gibt 2023-06-03T06:30Z zurück.

toString(now())

Gibt „2023-06-03T06:30Z“ zurück

now("Europe/Paris")

Gibt 2023-06-03T08:30+02:00 zurück.

nowWithDelta(<delta>,<date part>

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

Gibt einen Datum/Uhrzeit-Wert zurück.

nowWithDelta(-2, "hours")

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

Gibt einen Datum/Uhrzeit-Wert von vor genau 2 Stunden zurück.

nowWithDelta(1, "months", "Asia/Tokyo")

Wenn am 31.01.2026 ausgewertet, wird der Wert 2026-02-28T zurückgegeben…; wenn er am 31.05.2026 ausgewertet wird, wird der Wert 2026.06.30T zurückgegeben…

nowWithDelta() verwendet die Kalendermonatsarithmetik. Wenn der Zielmonat weniger Tage als der aktuelle Tag des Monats hat, wird das Ergebnis auf den letzten gültigen Tag dieses Monats normalisiert. Die Funktion wird nicht auf den folgenden Monat übertragen.

setHours(<dateTime>,<hours>)

Gibt einen Datum/Uhrzeit-Wert zurück.

setHours(<dateTimeOnly>,<hours>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

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

Gibt 2023-12-12T04:11:00Z zurück.

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

Gibt morgen um 20::XY Uhr zurück, wobei XY die Minuten zum Zeitpunkt der aktuellen Zeitauswertung darstellt. Wenn die Auswertung um 2::45 Uhr erfolgt, lautet die zurückgegebene Zeit 20::45 Uhr.

setDays(<dateTime>,<days>)

Gibt einen Datum/Uhrzeit-Wert zurück.

setDays(<dateTimeOnly>,<days>)

Gibt einen Datum/Uhrzeit-Wert ohne Berücksichtigung der Zeitzone zurück.

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

Gibt 2023-12-25T01:11:00Z zurück.

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

• Zeitzonen-ID: string
• dateTime

updateTimeZone(<dateTime>,<timeZone id>)

Gibt einen Datum/Uhrzeit-Wert zurück.

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

Gibt 2023-08-28T17:15:30.123+02:00 zurück.

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

Wenn der Wert des Zeitstempelfelds 2021-11-16T16:55:12.939318+01:00 ist, gibt die Funktion 2021-11-17T02:55:12.942115+11:00 zurück.

Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.

Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.

• TL;DR: Auf dieser Seite werden alle Datums- und Uhrzeitfunktionen dokumentiert, die in AJO-Journey-Ausdrücken verfügbar sind. Sie beschreiben, wie Sie die aktuelle Uhrzeit abrufen, überprüfen, ob ein Datum in ein relatives Zeitfenster fällt, und Datums-/Uhrzeitkomponenten ändern.

intents:

• Abrufen des aktuellen Datums-/Uhrzeitwerts (mit optionaler Zeitzone) mit now oder nowWithDelta
• Abrufen der aktuellen Zeit als Epochenzahl mit currentTimeInMillis
• Überprüfen Sie mithilfe von inLastDays, inLastHours, inLastMonths oder inLastYears, ob ein Datum/eine Uhrzeit in die letzten N Tage, Stunden, Monate oder Jahre fällt.
• Überprüfen Sie mithilfe von inNextDays, inNextHours, inNextMonths oder inNextYears, ob ein Datum/eine Uhrzeit in die nächsten N Tage, Stunden, Monate oder Jahre fällt.
• Erzwingen einer bestimmten Stunde oder eines bestimmten Tages des Monats für einen Datums-/Uhrzeitwert mithilfe von setHours oder setDays
• Konvertieren Sie eine Datums-/Uhrzeitangabe in eine andere Zeitzone, während Sie mit updateTimeZone denselben Zeitpunkt beibehalten.

Glossar:

• dateTime: Ein Datums-/Uhrzeitwert, der Zeitzonenversatzinformationen enthält (produktspezifisch)
• dateTimeOnly: Ein Datums-/Uhrzeitwert ohne Zeitzoneninformationen (produktspezifisch)
• Epochenmillisekunden: Eine Ganzzahl, die die Anzahl der seit 1970-01-01T00-00Z :00: Millisekunden darstellt
• delta: Ein ganzzahliger Offset (positiv oder negativ), der mit nowWithDelta verwendet wird, um die aktuelle Zeit um eine Anzahl von Jahren, Monaten, Tagen, Stunden, Minuten oder Sekunden zu verschieben

Leitplanken:

• now() ist nur in Journey-Ausdrücken verfügbar. Verwenden Sie stattdessen getCurrentZonedDateTime() für die E-Mail-Personalisierung
• Die Zeitzonen-ID in nowWithDelta muss eine Zeichenfolgenkonstante sein. Feldverweise und dynamische Ausdrücke werden nicht unterstützt
• Die Zeitzonen-ID in updateTimeZone muss eine Zeichenfolgenkonstante sein

Terminologie:

• Kanonischer Name: Datumsfunktionen — Akronym: none — Varianten: Datums-/Uhrzeitfunktionen, Zeitfunktionen
• Synonyme: „now()“ = „current datetime“; „currentTimeInMillis()“ = „Aktuelle Epoche Millisekunden“
• Verwechseln Sie nicht: „inLastDays“ (blickt zurück in die Zeit) ≠ „inNextDays“ (blickt in die Zeit)
• Verwechseln Sie nicht: „setHours“ (ersetzt die Stundenkomponente) ≠ „nowWithDelta“ (verschiebt die aktuelle Zeit)
• Verwechseln Sie nicht: „updateTimeZone“ (gleiche Darstellung des Zeitpunkts, andere Zeitzone) ≠ „setHours“ (ändert den Zeitwert selbst)

FAQ:

• F: Kann ich now() in E-Mail-Personalisierungsinhalten verwenden? — Nein, now() ist nur in Journey-Ausdrücken verfügbar. Verwenden Sie getCurrentZonedDateTime() für die E-Mail-Personalisierung.
• F: Wie kann ich überprüfen, ob ein Ereignis in den letzten 24 Stunden aufgetreten ist? — inLastHours(@event{MyEvent.timestamp}, 24) verwenden.
• F: Wie erhalte ich den aktuellen Zeitversatz um 2 Stunden in der Vergangenheit? — nowWithDelta(-2, "hours") verwenden.
• F: Was unterscheidet updateTimeZone von setHours? - updateTimeZone behält den Zeitpunkt bei, drückt ihn jedoch in einer anderen Zeitzone aus, während setHours die Stundenkomponente des Datetime-Werts tatsächlich ändert.
• F: Kann der Zeitzonenparameter in nowWithDelta ein Profilfeld sein? — Nein, die Zeitzonen-ID muss eine Zeichenfolgenkonstante sein. Feldverweise werden nicht unterstützt.
• F: Was passiert, wenn nowWithDelta() mit Monaten verwendet wird und das aktuelle Datum ein Monatsenddatum ist? — Die Funktion verwendet die Kalendermonatsarithmetik und normalisiert das Ergebnis auf den letzten gültigen Tag des Zielmonats. Wenn Sie beispielsweise 1 Monat zum 31. Januar hinzufügen, wird der 28. Februar zurückgegeben (nicht der 3. März).