Funzioni di conversione conversion-functions

Le funzioni di conversione consentono di trasformare i dati da un tipo all’altro all’interno delle espressioni di percorso. Queste funzioni sono essenziali per garantire la compatibilità dei dati e una corretta gestione del tipo quando si lavora con origini dati e operazioni diverse.

Utilizza le funzioni di conversione quando devi:

  • Converti i valori stringa in tipi numerici, booleani o di data (toInteger, toDecimal, toBool)
  • Trasforma date e ore tra formati e rappresentazioni diversi (toDateTime, toDateTimeOnly, toDateOnly)
  • Cast valori numerici tra tipi integer e decimal (toInteger, toDecimal)
  • Converti i valori in formato stringa (toString) o durata (toDuration)
  • Garantire la compatibilità dei tipi per confronti e operazioni
  • Elabora dati provenienti da origini esterne che possono avere formati di tipo diversi

Ogni funzione di conversione gestisce in automatico regole e casi edge specifici del tipo, rendendo la trasformazione dei dati più affidabile e prevedibile nelle espressioni di percorso.

toBool toBool

Converte un valore di argomento in un valore booleano, a seconda del tipo.

  • Da stringa: prova a convertire il valore stringa come booleano; da "true" se il valore stringa è "true"; in caso contrario false
  • Dal valore numerico: true se il valore numerico non è uguale a 0, false in caso contrario
Sintassi
toBool(<parameter>)
Parametri
  • decimale
  • booleano
  • stringa
  • intero
Firme e tipi restituiti

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Restituisce un valore booleano.

Esempi

toBool("true")

toBool(1)

Restituisce true.

toBool("this is not a boolean")

Restituisce false.

toDateOnly toDateOnly

Converte un argomento in un valore di tipo dateOnly. Per ulteriori informazioni sui tipi di dati, consulta questa sezione.

Sintassi
toDateOnly(<parameters>)
Parametri
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parametro Tipo
Rappresentazione stringa di una data come "AAAA-MM-GG" (formato XDM). Supporta anche il formato ISO-8601: viene considerata solo la parte full-date (consultare RFC 3339, sezione 5.6 stringa
data e ora dateTime
data e ora senza fuso orario dateTimeOnly
valore intero di un’epoca in millisecondi intero
Firme e tipi restituiti

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Restituisce un valore di tipo dateOnly.

Esempi

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 toDateTime

Converte i parametri in un valore di data e ora, a seconda del tipo.

Sintassi
toDateTime(<parameters>)
Parametri
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parametro Tipo
data e ora nel formato ISO-8601 stringa
id fuso orario stringa
data e ora senza fuso orario dateTimeOnly
valore intero di un’epoca in millisecondi intero
Firme e tipi restituiti

toDateTime(<string>)

toDateTime(<stringified time zone id>, <dateTimeOnly>)

toDateTime(<integer>)

Restituisce un valore dateTime.

Esempi

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

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

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

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

toDateTime(1560762190189)

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

NOTE
L’ID del fuso orario deve essere una costante stringa. Non può essere un riferimento di campo né un'espressione. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.

toDateTimeOnly toDateTimeOnly

Converte un valore di argomento in un valore di sola data e ora.

Sintassi
toDateTimeOnly(<parameters>)
Parametri
table 0-row-2 1-row-2 2-row-2
Parametro Tipo
data e ora in formato ISO-8601 o "AAAA-MM-GG" (formato data XDM) stringa
data e ora dateTime
Firme e tipi restituiti

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Restituisce un valore datetime senza considerare il fuso orario.

Esempi

toDateTimeOnly ("2023-08-18")

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

toDateTimeOnly(now())

toDecimal toDecimal

Converte un valore di argomento in un valore decimale, a seconda del tipo.

Sintassi
toDecimal(<parameter>)
Parametri
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parametro Descrizione
stringa converte il valore stringa come decimale
dateTime converte la data in millisecondi (millisecondi epoca)
booleano converte il valore booleano come 1 se true, 0 se false
intero converte in un decimale (ad esempio.: 1 diventa 1,0)
Firme e tipi restituiti

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Restituisce un decimale.

Esempi

toDecimal("4.0")

Restituisce 4,0.

toDuration toDuration

Converte un valore di argomento in una durata. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.

Sintassi
toDuration(<parameter>)
Parametri
table 0-row-2 1-row-2 2-row-2
Parametro Descrizione
stringa formati basati sul formato di durata ISO-8601 PnDTnHnMn.nS con giorni considerati esattamente 24 ore
intero numero di millisecondi

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.

Firme e tipo restituito

toDuration(<string>)

toDuration(<integer>)

Restituisce una durata.

Esempi

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 toInteger

Converte un valore di argomento in un numero intero.

Sintassi
toInteger(<parameter>)
Parametri
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parametro Descrizione
stringa converte il valore stringa come numero intero
dateTime converte la data in millisecondi (millisecondi epoca)
decimale converte in numero intero rimuovendo la parte decimale (ad esempio: 1,5 diventa 1)
booleano converte il valore booleano come 1 se true, 0 se false
Firme e tipo restituito

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Restituisce un numero intero.

Esempi

toInteger("4")

Restituisce 4.

toString toString

Converte un valore di argomento in un valore stringa, a seconda del tipo. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.

Sintassi
toString(<parameter>)
Parametri
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Parametro Descrizione
dateTime converte la data nel formato data UTC
dateTimeOnly converte la data nel formato data UTC
durata convertire nel numero di millisecondi corrispondente come stringa
intero converte in rappresentazione stringa del valore (1 diventa "1")
decimale converte in rappresentazione stringa del valore (1,5 diventa "1,5")
booleano converti il valore booleano come 'true' se true, 'false' se false
Firme e tipo restituito

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Restituisce una stringa.

Esempi

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".

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76