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
toBool(<parameter>)- 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 toDateOnly
Converte un argomento in un valore di tipo dateOnly. Per ulteriori informazioni sui tipi di dati, consulta questa sezione.
toDateOnly(<parameters>)| 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 |
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 toDateTime
Converte i parametri in un valore di data e ora, a seconda del tipo.
toDateTime(<parameters>)| 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 |
toDateTime(<string>)
toDateTime(<stringified time zone id>, <dateTimeOnly>)
toDateTime(<integer>)
Restituisce un valore dateTime.
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
toDateTimeOnly toDateTimeOnly
Converte un valore di argomento in un valore di sola data e ora.
toDateTimeOnly(<parameters>)| 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 |
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 toDecimal
Converte un valore di argomento in un valore decimale, a seconda del tipo.
toDecimal(<parameter>)| 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) |
toDecimal(<integer>)
toDecimal(<decimal>)
toDecimal(<string>)
toDecimal(<boolean>)
Restituisce un decimale.
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.
toDuration(<parameter>)| 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.
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 toInteger
Converte un valore di argomento in un numero intero.
toInteger(<parameter>)| 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 |
toInteger(<dateTime>)
toInteger(<decimal>)
toInteger(<integer>)
toInteger(<string>)
toInteger(<boolean>)
Restituisce un numero intero.
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.
toString(<parameter>)| 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 |
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".