Funzioni di conversione conversion-functions

• decimale
• booleano
• stringa
• intero

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Restituisce un valore booleano.

toBool("true")

toBool(1)

Restituisce true.

toBool("this is not a boolean")

Restituisce false.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Restituisce un valore di tipo dateOnly.

toDateOnly("2023-08-18")

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

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

tutti restituiscono un oggetto dateOnly che rappresenta il 18 agosto 2023.

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

Restituisce un valore dateOnly.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Restituisce un valore dateTime.

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

Restituisce 2023-08-18T23:17:59.123Z

La stringa ISO-8601 include già informazioni sul fuso orario.

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

Restituisce 2023-08-18T00:00:00.000+02:00

Questo crea un dateTime combinando un fuso orario con un valore solo data. L’ora è impostata su mezzanotte (00:00:00) nel fuso orario specificato.

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

Restituisce 2023-08-18T23:17:59.123Z

Viene creato un valore dateTime applicando un fuso orario a un valore dateTimeOnly (che non contiene informazioni sul fuso orario).

toDateTime(1560762190189)

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

Converte una marca temporale Unix in millisecondi in un valore dateTime.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Restituisce un valore datetime senza considerare il fuso orario.

toDateTimeOnly ("2023-08-18")

restituisce un valore dateTime che rappresenta 2023-08-18T00:00:00.000

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Restituisce un decimale.

toDecimal("4.0")

Restituisce 4,0.

Espressione stringa: i formati accettati sono basati sul formato di durata ISO-8601 PnDTnHnMn.nS con giorni considerati esattamente 24 ore.

La stringa inizia con un segno facoltativo, indicato dal simbolo ASCII negativo o positivo. Se negativo, l’intero periodo viene ignorato. La lettera ASCII “P” è successiva in maiuscolo o in minuscolo. Ci sono poi quattro sezioni, ciascuna composta da un numero e un suffisso. Le sezioni hanno suffissi in ASCII di “D”, “H”, “M” e “S” per giorni, ore, minuti e secondi, accettati in maiuscolo o minuscolo. I suffissi devono essere disposti in ordine. La lettera ASCII “T” deve precedere la prima occorrenza, se presente, di un’ora, un minuto o una seconda sezione. Deve essere presente almeno una delle quattro sezioni e, se “T” è presente, deve esserci almeno una sezione dopo la “T”. La parte numerica di ogni sezione deve essere costituita da una o più cifre ASCII. Il numero può essere preceduto dal simbolo ASCII negativo o positivo. Il numero di giorni, ore e minuti deve essere analizzato in lungo. Il numero di secondi deve essere analizzato insieme alla frazione facoltativa. Il punto decimale può essere un punto o una virgola. La parte frazionaria può avere da zero a 9 cifre.

toDuration(<string>)

toDuration(<integer>)

Restituisce una durata.

toDuration("PT10H")

Restituisce una durata di 10 ore.

toDuration("PT4S")

Restituisce una durata di 4 secondi.

toDuration(4000)

Restituisce una durata di 4 secondi.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Restituisce un numero intero.

toInteger("4")

Restituisce 4.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Restituisce una stringa.

toString(4)

Restituisce “4”.

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

Restituisce la rappresentazione in forma di stringa del campo dataOnly specificato (campo Data XDM), ad esempio “2023-08-18”.

toString(toDuration(1520))

Restituisce “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.