Datums-/Uhrzeitfunktionen 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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

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) %}

{%= dateDiff(getCurrentZonedDateTime(), stringToDate(profile.events.subscriptionEndDate)) %}

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}
{%#if daysLeft > 0%}
Your points expire in {{daysLeft}} day{%#if daysLeft > 1%}s{%/if%} — use them before they're gone!
{%else%}
Your points have expired.
{%/if%}

Datum zwischen date-between

Die Funktion dateBetween prüft, ob ein bestimmtes Datum zwischen einem Start- und einem Enddatum liegt, einschließlich für beide Grenzen.

Syntax

{%= dateBetween(date, startDate, endDate) %}

++Beispiel

++

Tag des Monats day-month

Die Funktion dayOfMonth gibt die Zahl zurück, die dem Tag des Monats entspricht.

Syntax

{%= dayOfMonth(datetime) %}

Wochentag day-week

Die dayOfWeek-Funktion wird zum Abrufen des Wochentags verwendet. Sie gibt eine Ganzzahl zwischen 1 (Montag) und 7 (Sonntag) zurück, die der Norm ISO-8601 folgt.

Syntax

{%= dayOfWeek(datetime) %}

{%#if dayOfWeek(getCurrentZonedDateTime()) = 6 or dayOfWeek(getCurrentZonedDateTime()) = 7%}
We're closed on weekends — your request will be processed on the next business day.
{%else%}
Our team will get back to you within 24 hours.
{%/if%}

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) %}

Stunden extrahieren extract-hours

Die Funktion extractHours extrahiert die Stundenkomponente aus einem bestimmten Zeitstempel.

Syntax

{%= extractHours(date) %}

Minuten extrahieren extract-minutes

Die Funktion extractMinutes extrahiert die Minutenkomponente aus einem bestimmten Zeitstempel.

Syntax

{%= extractMinutes(date) %}

{% let h = extractHours(getCurrentZonedDateTime()) %}
{% let m = extractMinutes(getCurrentZonedDateTime()) %}
Your appointment is confirmed for {{h}}:{%#if m < 10%}0{%/if%}{{m}}.

Monate extrahieren extract-months

Die Funktion extractMonth extrahiert die Monatskomponente aus einem bestimmten Zeitstempel.

Syntax

{%= extractMonths(date) %}

Sekunden extrahieren extract-seconds

Die Funktion extractSeconds extrahiert die Sekundenkomponente aus einem bestimmten Zeitstempel.

Syntax

{%= extractSeconds(date) %}

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 der erste Parameter das Datums-/Uhrzeitattribut und der zweite Wert gibt an, wie das Datum konvertiert und angezeigt werden soll.

Beispiele

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}

{%= formatDate(stringToDate(profile.person.birthDayAndMonth), "MM/DD/YY") %}

{%= formatDate(profile.person.birthDateTime, "EEEE MMMM dd yyyy") %}

{%= formatDate(getCurrentZonedDateTime(), "MM/dd/YYYY") %}

{%= formatDate(getCurrentZonedDateTime(), "EEE") %}

{%= lowerCase(formatDate(getCurrentZonedDateTime(), "EEE")) %}

{% let appointmentDate = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy HH:mm") %}
{{appointmentDate}}

Musterzeichen pattern-characters

Einige Musterzeichen sehen möglicherweise ähnlich aus, stellen jedoch unterschiedliche Konzepte dar.

Formatieren des Datums mit Unterstützung für Gebietsschema format-date-locale

Die Funktion formatDate kann verwendet werden, um einen Datums-/Uhrzeitwert in der entsprechenden sprachabhängigen 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.

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() %}

Stundendifferenz hours-difference

Die Funktion diffInHours gibt den Unterschied zwischen zwei Daten in Form von Stunden zurück.

Syntax

{%= diffInHours(endDate, startDate) %}

Minutendifferenz diff-minutes

Die Funktion diffInMinutes gibt den Unterschied zwischen zwei Daten in Form von Minuten zurück.

Syntax

{%= diffInMinutes(endDate, startDate) %}

Monatsdifferenz months-difference

Die Funktion diffInMonths gibt den Unterschied zwischen zwei Daten in Form von Monaten zurück.

Syntax

{%= diffInMonths(endDate, startDate) %}

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) %}

{%= addDays(stringToDate(profile.subscription.endDate), -7) %}

{%= setHours(addDays(stringToDate(profile.subscription.endDate), -7), 9) %}

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) %}

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

Mit der Funktion truncateToStartOfDay wird eine Datums-/Uhrzeitangabe geändert, indem die Uhrzeit auf den Beginn des Tages mit 00:00 Uhr festgelegt wird.

Syntax

{%= truncateToStartOfDay(date) %}

truncateToStartOfQuarter truncate-quarter

Mit der Funktion truncateToStartOfQuarter wird eine Datums-/Uhrzeitangabe auf den ersten Tag des Quartals (z. B. 1. Januar, 1. April, 1. Juli, 1. Oktober) um 0:00 Uhr gekürzt.

Syntax

{%= truncateToStartOfQuarter(dateTime) %}

truncateToStartOfWeek truncate-week

Die truncateToStartOfWeek-Funktion ändert eine bestimmte Datums-/Uhrzeitangabe, indem sie sie auf den Beginn der Woche (Montag um 00:00 Uhr) setzt.

Syntax

{%= truncateToStartOfWeek(dateTime) %}

truncateToStartOfYear truncate-year

Mit der Funktion truncateToStartOfYear wird eine Datums-/Uhrzeitangabe geändert, indem sie auf den ersten Tag des Jahres (1. Januar) um 0:00 Uhr gekürzt wird.

Syntax

{%= truncateToStartOfYear(dateTime) %}

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