Konvertierungsfunktionen conversion-functions

• decimal
• boolean
• string
• Ganzzahl

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Geben einen booleschen Wert zurück.

toBool("true")

toBool(1)

Gibt „true“ zurück.

toBool("this is not a boolean")

Gibt „false“ zurück.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

toDateOnly(<integer>, <integer>, <integer>)

Gibt einen Wert vom Typ dateOnly zurück.

toDateOnly("2023-08-18")

toDateOnly("2023-08-18T00:00:00.000Z")

toDateOnly("2023-08-18T00:00:00")

alle geben ein dateOnly-Objekt zurück, das den 18.08.2023 darstellt.

toDateOnly(#{ExperiencePlatform.ProfileFieldGroup.person.birthDate})

Gibt ein dateOnly zurück.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Gibt einen Datum/Uhrzeit-Wert zurück.

toDateTime("2023-08-18T23:17:59.123Z")

Gibt 2023-08-18T23:17:59.123Z zurück.

Die ISO-8601-Zeichenfolge enthält bereits Zeitzoneninformationen.

toDateTime("Europe/Paris", toDateOnly("2023-08-18"))

Gibt „2023-08-18T00:00:00.000+02:00“ zurück

Dadurch wird ein dateTime-Wert erstellt, indem eine Zeitzone mit einem reinen Datumswert kombiniert wird. Die Uhrzeit wird in der angegebenen Zeitzone auf Mitternacht (00:00:00) festgelegt.

toDateTime("UTC", toDateTimeOnly("2023-08-18T23:17:59.123"))

Gibt „2023-08-18T23:17:59.123Z“ zurück

Dadurch wird ein dateTime-Wert erstellt, indem eine Zeitzone auf einen dateTimeOnly-Wert angewendet wird (der keine Zeitzoneninformationen enthält).

toDateTime(1560762190189)

Gibt „2019-06-17T09:03:10.189Z“ zurück

Konvertiert einen Unix-Zeitstempel in Millisekunden in einen dateTime-Wert.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

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

toDateTimeOnly ("2023-08-18")

Gibt einen Datum/Uhrzeit-Wert zurück, der 2023-08-18T00:00:00.000 entspricht.

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Gibt eine Dezimalzahl zurück.

toDecimal("4.0")

Gibt 4.0 zurück.

Wenn Zeichenfolgenausdruck: Akzeptierte Formate basieren auf dem ISO 8601-Dauerformat PnDTnHnMn.nS, wobei Tage als genau 24 Stunden betrachtet werden.

Die Zeichenfolge beginnt mit einem optionalen Zeichen, markiert durch das negative oder positive ASCII-Symbol. Bei negativen Werten wird der gesamte Zeitraum negiert. Der ASCII-Buchstabe „P“ folgt in Groß- oder Kleinschreibung. Dann gibt es vier Bereiche, die jeweils aus einer Zahl und einem Suffix bestehen. Die Bereiche weisen die ASCII-Suffixe von „D“, „H“, „M“ und „S“ für Tage, Stunden, Minuten und Sekunden auf, akzeptiert in Groß- oder Kleinschreibung. Die Suffixe müssen in richtiger Reihenfolge erscheinen. Der ASCII-Buchstabe „T“ muss vor dem ersten Auftreten, so vorhanden, einer Stunde, einer Minute oder eines zweiten Bereichs stehen. Es muss mindestens einer der vier Bereiche vorhanden sein und wenn „T“ vorhanden ist, muss mindestens ein Bereich auf das „T“ folgen. Der Zahlenteil der einzelnen Bereiche muss aus einer oder mehreren ASCII-Ziffern bestehen. Der Zahl kann das negative oder positive ASCII-Symbol vorangestellt werden. Die Zahl der Tage, Stunden und Minuten muss zu einem „long“ ausgewertet werden. Die Zahl der Sekunden muss zu einem „long“ mit optionalem Bruch ausgewertet werden. Das Dezimalzeichen kann ein Punkt oder ein Komma sein. Der Bruchteil kann zwischen null und neun Stellen aufweisen.

toDuration(<string>)

toDuration(<integer>)

Gibt eine Dauer zurück.

toDuration("PT10H")

Gibt eine Dauer von 10 Stunden zurück.

toDuration("PT4S")

Gibt eine Dauer von 4 Sekunden zurück.

toDuration(4000)

Gibt eine Dauer von 4 Sekunden zurück.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Gibt eine Ganzzahl zurück.

toInteger("4")

Gibt 4 zurück.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Gibt eine Zeichenfolge zurück.

toString(4)

Gibt „4“ zurück.

toString(#{ExperiencePlatform.test_date.person.birthDate}))

Gibt die Zeichenfolgendarstellung des angegebenen dateOnly-Feldes (XDM-Datumsfeld) zurück, beispielsweise „18.08.2023“.

toString(toDuration(1520))

Gibt „PT1.52S“ 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 Konversionsfunktionen in AJO-Journey-Ausdrücken dokumentiert und erläutert, wie Werte zwischen Typen wie Zeichenfolge, Ganzzahl, Dezimalzahl, Boolesch, Datum, Datum/Uhrzeit und Dauer transformiert werden.

intents:

• Konvertieren einer Zeichenfolge oder einer Epochenzahl in eine Zeitzonen-abhängige Datums-/Uhrzeitangabe mithilfe von toDateTime
• Konvertieren einer Zeichenfolge oder einer Datetime in eine Datetime ohne Zeitzone mithilfe von toDateTimeOnly
• Extrahieren eines reinen Datumswerts (Jahr-Monat-Tag) aus einer Zeichenfolge oder einem Datum/Uhrzeit-Wert mithilfe von toDateOnly
• Wandeln Sie einen Wert mithilfe von toInteger, toDecimal oder toBool in eine Ganzzahl, eine Dezimalzahl oder einen booleschen Wert um
• Serialisieren eines beliebigen Werts in seine Zeichenfolgendarstellung mithilfe von toString
• Konvertieren einer Zeichenfolge oder einer Ganzzahl in eine Dauer mithilfe von toDuration

Glossar:

• dateTime: Ein Datetime-Wert, der Zeitzonen-Offset-Informationen produktspezifisch) enthält
• dateTimeOnly: Ein Datetime-Wert ohne Zeitzoneninformationen (produktspezifisch)
• dateOnly: Ein Datumswert, der einen Jahr-Monat-Tag ohne Zeitkomponente darstellt (produktspezifisch)
• duration: Ein Zeitraum im ISO-8601-Format (z. B. PT10H) produktspezifisch)
• Epochenmillisekunden: Unix-Zeitstempel, ausgedrückt in Millisekunden seit 1970-01-01T00:00:00Z

Leitplanken:

• Das Zeitzonenargument in toDateTime muss eine Zeichenfolgenkonstante sein. Feldverweise und dynamische Ausdrücke sind nicht zulässig
• Zeichenfolgeneingaben für toDateTime und toDateTimeOnly müssen dem ISO-8601-Format entsprechen; falsch formatierte Zeichenfolgen geben null ohne Fehler zurück
• toDateTime mit einer Epochenzahl erwartet Millisekunden. Multiplizieren Sie sekundenbasierte Zeitstempel mit 1000, bevor Sie den Test übergeben
• toBool gibt true nur für die exakte "true" zurück; Zeichenfolgen wie "1", "yes" oder "TRUE" geben false zurück

Terminologie:

• Kanonischer Name: Konversionsfunktionen — Akronym: none — Varianten: Typengießfunktionen, Typenkonversionsfunktionen
• Synonyme: „toDateTime“ = „Konvertieren in datetime mit timezone“; „toDateTimeOnly“ = „Konvertieren in datetime ohne timezone“
• Verwechseln Sie nicht: „toDateTime“ (Zeitzonen-fähig) ≠ „toDateTimeOnly“ (keine Zeitzone)
• Verwechseln Sie nicht: „toDateOnly“ (nur Datum, keine Uhrzeit) ≠ „toDateTime“ (Datum und Uhrzeit mit Zeitzone)

FAQ:

• F: Wann sollte ich toDateTime versus toDateTimeOnly verwenden? — Verwenden Sie toDateTime, wenn Zeitzoneninformationen wichtig sind (z. B. Planung oder regionenübergreifende Vergleiche). Verwenden Sie toDateTimeOnly, wenn nur die lokale Datums-/Uhrzeitangabe relevant ist und die Zeitzone ignoriert werden kann.
• F: Warum gibt toBool("TRUE") „false“ zurück? — toBool erkennt nur die exakte "true" in Kleinbuchstaben. Alle anderen Zeichenfolgenwerte, einschließlich "TRUE" oder "yes", geben „false“ zurück.
• F: Wie konvertiere ich einen Unix-Zeitstempel in Sekunden in eine dateTime? — Multiplizieren Sie den Sekundenwert mit 1000, um Millisekunden zu erhalten, und übergeben Sie ihn dann an toDateTime, z. B. toDateTime(myField * 1000).
• F: Kann die Zeitzone in toDateTime aus einem Profilattribut gelesen werden? — Nein, die Zeitzonen-ID muss eine Zeichenfolgenkonstante sein. Feldverweise und -ausdrücke werden nicht unterstützt.
• F: Welches Format akzeptiert toDuration als Zeichenfolge? — ISO-8601-Dauerformat, z. B. "PT10H" für 10 Stunden oder "P1DT2H" für 1 Tag und 2 Stunden.