Fonctions de conversion conversion-functions

• décimal
• booléen
• chaîne
• entier

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Renvoie une valeur booléenne.

toBool("true")

toBool(1)

Renvoie true.

toBool("this is not a boolean")

Renvoie false.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Renvoie une valeur de type dateOnly.

toDateOnly("2023-08-18")

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

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

renvoient tous un objet dateOnly représentant 18/08/2023.

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

Renvoie une valeur dateOnly.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Renvoie une valeur dateTime.

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

Renvoie 2023-08-18T23:17:59.123Z.

La chaîne ISO-8601 inclut déjà des informations sur le fuseau horaire.

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

Renvoie 2023-08-:00:00.000+02:00

Vous créez ainsi une valeur dateTime en combinant un fuseau horaire avec une valeur de date seule. L’heure est définie sur minuit (00:00:00) dans le fuseau horaire spécifié.

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

Renvoie 2023-08-18T23:17:59.123Z.

Vous créez ainsi une valeur dateTime en appliquant un fuseau horaire à une valeur dateTimeOnly (qui ne contient aucune information de fuseau horaire).

toDateTime(1560762190189)

Renvoie 2019-06-17T09:03:10.189Z

Convertit une date et une heure Unix en millisecondes en une valeur dateTime.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Renvoie une date et une heure sans prendre en compte le fuseau horaire.

toDateTimeOnly ("2023-08-18")

Renvoie une valeur dateTime représentant 2023-08-18T00:00:00.000.

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Renvoie une valeur décimale.

toDecimal("4.0")

Renvoie 4.0.

Si l’expression contient une chaîne : les formats acceptés sont basés sur le format de durée ISO-8601 PnDTnHnMn.nS pour une durée du jour considérée comme durant exactement 24 heures.

La chaîne commence par un signe facultatif, indiqué par le symbole ASCII négatif ou positif. S’il est négatif, toute la période est annulée. Vient ensuite la lettre ASCII « P », en majuscule ou en minuscule. Viennent ensuite quatre sections, chacune constituée d’un nombre et d’un suffixe. Les sections contiennent les suffixes en ASCII « D », « H », « M » et « S » pour les jours, heures, minutes et secondes, acceptés en majuscules ou en minuscules. Les suffixes doivent se succéder dans l’ordre. La lettre ASCII « T » doit apparaître avant la première occurrence, le cas échéant, d’une section d’heure, de minute ou de seconde. L’une au moins des quatre sections doit être présente, et si la lettre « T » est présente, elle doit être suivie d’au moins une section. La partie numérique de chaque section doit contenir un ou plusieurs chiffres ASCII. Le nombre peut être précédé du symbole ASCII négatif ou positif. Le nombre de jours, heures et minutes doit être converti en nombre long. Le nombre de secondes doit être converti en nombre long avec la fraction facultative. La virgule peut être un point ou une virgule. La partie fractionnaire peut comporter de zéro à 9 chiffres.

toDuration(<string>)

toDuration(<integer>)

Renvoie une durée.

toDuration("PT10H")

Renvoie une durée de 10 heures.

toDuration("PT4S")

Renvoie une durée de 4 s.

toDuration(4000)

Renvoie une durée de 4 s.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Renvoie un nombre entier.

toInteger("4")

Renvoie 4.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Renvoie une chaîne.

toString(4)

Renvoie « 4 ».

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

Renvoie la représentation sous forme de chaîne du champ dateOnly (champ de date XDM) donné, par exemple « 18/08/2023 ».

toString(toDuration(1520))

Renvoie « PT1.52S ».

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page documents all conversion functions in AJO journey expressions, explaining how to transform values between types such as string, integer, decimal, boolean, date, datetime, and duration.

Intents:

• Convert a string or epoch integer to a timezone-aware datetime using toDateTime
• Convert a string or datetime to a timezone-less datetime using toDateTimeOnly
• Extract a date-only value (year-month-day) from a string or datetime using toDateOnly
• Cast a value to an integer, decimal, or boolean using toInteger, toDecimal, or toBool
• Serialize any value to its string representation using toString
• Convert a string or millisecond integer to a duration using toDuration

Glossary:

• dateTime: A datetime value that includes timezone offset information (product-specific)
• dateTimeOnly: A datetime value with no timezone information (product-specific)
• dateOnly: A date value representing year-month-day with no time component (product-specific)
• duration: A time period expressed in ISO-8601 format (e.g., PT10H) (product-specific)
• epoch milliseconds: Unix timestamp expressed in milliseconds since 1970-01-01T00:00:00Z

Guardrails:

• The timezone argument in toDateTime must be a string constant — field references and dynamic expressions are not allowed
• String inputs to toDateTime and toDateTimeOnly must follow ISO-8601 format; malformed strings return null without an error
• toDateTime with an epoch integer expects milliseconds; multiply seconds-based timestamps by 1000 before passing
• toBool returns true only for the exact string "true"; strings like "1", "yes", or "TRUE" return false

Terminology:

• Canonical name: Conversion functions — Acronym: none — variants: type casting functions, type conversion functions
• Synonyms: “toDateTime” = “convert to datetime with timezone”; “toDateTimeOnly” = “convert to datetime without timezone”
• Do not confuse: “toDateTime” (timezone-aware) ≠ “toDateTimeOnly” (no timezone)
• Do not confuse: “toDateOnly” (date only, no time) ≠ “toDateTime” (date and time with timezone)

FAQ:

• Q: When should I use toDateTime versus toDateTimeOnly? — Use toDateTime when timezone information matters (e.g., scheduling or cross-region comparisons); use toDateTimeOnly when only the local date-time is relevant and timezone can be ignored.
• Q: Why does toBool("TRUE") return false? — toBool only recognizes the exact lowercase string "true"; all other string values including "TRUE" or "yes" return false.
• Q: How do I convert a Unix timestamp in seconds to a dateTime? — Multiply the seconds value by 1000 to get milliseconds, then pass it to toDateTime, e.g., toDateTime(myField * 1000).
• Q: Can the timezone in toDateTime be read from a profile attribute? — No, the timezone ID must be a string constant; field references and expressions are not supported.
• Q: What format does toDuration accept as a string? — ISO-8601 duration format, e.g., "PT10H" for 10 hours or "P1DT2H" for 1 day and 2 hours.