Datumsfunktionen date-functions
Mit Datumsfunktionen können Sie Datums- und Uhrzeitwerte in Ihren Journey-Ausdrücken bearbeiten. Diese Funktionen sind für zeitbasierte Bedingungen, Zeitpläne und zeitliche Berechnungen in Ihren Kunden-Journey unerlässlich.
Verwenden Sie Datumsfunktionen, wenn Sie Folgendes tun müssen:
- Abrufen der aktuellen Zeit oder des aktuellen Datums mit spezifischer Zeitzonenbehandlung (now, nowWithDelta, currentTimeInMillis)
- Überprüfen, ob ein Datum in einen bestimmten Zeitbereich fällt (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, inNextMonths, inNextYears)
- Ändern von Datums- und Zeitkomponenten (setHours, setDays, updateTimeZone)
- Durchführen von zeitbasierten Berechnungen und Vergleichen
- Zwischen verschiedenen Zeitformaten und Darstellungen konvertieren
Datumsfunktionen bieten eine präzise Kontrolle über die zeitliche Logik, sodass Sie zeitabhängige Journey-Pfade und Bedingungen erstellen können, die auf bestimmte Zeitrahmen und Zeitpläne reagieren.
currentTimeInMillis currentTimeInMillis
Gibt die aktuelle Zeit in Epoch-Millisekunden zurück.
currentTimeInMillis()currentTimeInMillis()
Gibt eine Ganzzahl zurück.
currentTimeInMillis()
Gibt „1544712617131“ zurück.
inLastDays inLastDays
Gibt „true“ zurück, wenn ein bestimmtes „dateTime“ zwischen jetzt und jetzt-Delta-Tage liegt.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inLastDays(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inLastHours inLastHours
Gibt „true“ zurück, wenn der angegebene Datum/Uhrzeit-Wert zwischen jetzt und jetzt - delta Stunden liegt.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
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 inLastMonths
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt - delta Monaten liegt.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inLastMonths(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inLastYears inLastYears
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt - delta Jahren liegt.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inLastYears(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inNextDays inNextDays
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt + delta Tagen liegt.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inNextDays(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inNextHours inNextHours
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt + delta Stunden liegt.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inNextHours(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inNextMonths inNextMonths
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt + delta Monaten liegt.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inNextMonths(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Gibt „true“ zurück.
inNextYears inNextYears
Gibt „true“ zurück, wenn der angegebene Datums- bzw. Datum/Uhrzeit-Wert zwischen jetzt und jetzt + delta Jahren liegt.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| delta | integer |
inNextYears(<dateTime>,<integer>)
Gibt einen booleschen Wert zurück.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Gibt „true“ zurück.
now now
Gibt das aktuelle Datum im Datum/Uhrzeit-Format zurück. Weitere Informationen zu Datentypen finden Sie auf dieser Seite.
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parameter | Beschreibung |
| string | Zeitzonenkennung (optional) |
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 nowWithDelta
Gibt den aktuellen Datum/Uhrzeit-Wert einschließlich Verschiebung zurück. Wenn eine Zeitzonen-ID angegeben wird, wird die Zeitzonenverschiebung angewendet. Weitere Informationen zu Datentypen finden Sie auf dieser Seite.
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Beschreibung |
| delta | positiver oder negativer Ganzzahlwert |
| date part | Jahre, Monate, Tage, Stunden, Minuten oder Sekunden als Zeichenfolge |
| Zeitzonen-ID | Zeichenfolgendarstellung des Zeitzonenwerts. Weitere Informationen finden Sie unter Datentypen. Die Zeitzonen-ID muss eine Zeichenfolgenkonstante sein. Er darf weder ein Feldverweis noch ein Ausdruck sein. |
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.
setHours setHours
Legt die Stunden eines Datum/Uhrzeit-Werts oder Datum/Uhrzeit-Werts ohne Zeitzone fest. Wenn Sie beispielsweise morgen bis zu einer bestimmten Stunde warten möchten, können Sie die Stunde erzwingen.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| Datum/Uhrzeit ohne Berücksichtigung der Zeitzone | dateTimeOnly |
| Stunden | Ganzzahl |
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 setDays
Legt den Tag eines Datum/Uhrzeit-Werts oder Datum/Uhrzeit-Werts ohne Zeitzone fest. Wenn Sie beispielsweise bis zu einem bestimmten Tag des Monats warten möchten, können Sie den Tag erzwingen.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Typ |
| Datum/Uhrzeit | dateTime |
| Datum/Uhrzeit ohne Berücksichtigung der Zeitzone | dateTimeOnly |
| Tage | integer |
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)
updateTimeZone updateTimeZone
Gibt einen neuen Datum/Uhrzeit-Wert mit einer neuen Zeitzone zum selben Moment zurück.
updateTimeZone(<parameters>)- 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.