Funções de conversão conversion-functions

Sintaxe

Parâmetros

• decimal
• booleano
• sequência de caracteres
• inteiro

Assinaturas e tipos retornados

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Retornar um booleano.

Exemplos

toBool("true")

toBool(1)

Retorna verdadeiro.

toBool("this is not a boolean")

Retorna falso.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parâmetro	Tipo
Representação em sequência de caracteres de uma data como "AAAA-MM-DD" (formato XDM). Também é compatível com o formato ISO-8601: apenas a parte full-date é considerada (Consulte RFC 3339, seção 5.6	sequência de caracteres
data e hora	dateTime
data hora sem fuso horário	dateTimeOnly
valor inteiro de uma época em milissegundos	inteiro

Assinaturas e tipos retornados

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Retorna um valor de tipo dateOnly.

Exemplos

toDateOnly("2023-08-18")

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

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

todos retornam um objeto dateOnly representando 2023-08-18.

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

Retorna um dateOnly.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Parâmetro	Descrição
sequência de caracteres	data e hora no formato ISO-8601. Uma representação da string de um datetime com informações de fuso horário
sequência de caracteres	id do fuso horário. Um identificador de fuso horário (por exemplo, "UTC", "Europa/Paris")
dateOnly	representa uma data sem fuso horário, visualizada como ano-mês-dia
dateTimeOnly	representa um datetime sem um fuso horário, exibido como year-month-day-hour-minute-second-milisecond
inteiro	valor inteiro de uma época em milissegundos

Assinaturas e tipos retornados

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Retornar um dateTime.

Exemplos

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

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

A cadeia de caracteres ISO-8601 já inclui informações de fuso horário.

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

Retorna 18T00:00:00.000+02:00 de 2023

Isso cria um dateTime combinando um fuso horário com um valor somente de data. A hora é definida como meia-noite (00:00:00) no fuso horário especificado.

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

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

Isso cria um dateTime aplicando um fuso horário a um valor dateTimeOnly (que não tem informações de fuso horário).

toDateTime(1560762190189)

Retorna 17T09:03:10.189Z de 2019

Converte um carimbo de data e hora Unix em milissegundos em um valor dateTime.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2
Parâmetro	Tipo
data e hora no formato ISO-8601 ou "AAAA-MM-DD" (formato de data XDM)	sequência de caracteres
data e hora	dateTime

Assinaturas e tipos retornados

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Retorna um datetime sem considerar o fuso horário.

Exemplos

toDateTimeOnly ("2023-08-18")

retorna um dateTime representando 2023-08-18T00:00:00.000

toDateTimeOnly(now())

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parâmetro	Descrição
sequência de caracteres	converte o valor da string em um decimal
dateTime	converte a data no número de milissegundos (milissegundos da época)
booleano	converte o valor booleano como 1 se verdadeiro, 0 se falso
inteiro	converte para um decimal (exemplo.: 1 torna-se 1.0)

Assinaturas e tipos retornados

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Retorna um decimal.

Exemplos

toDecimal("4.0")

Retorna 4.0.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2
Parâmetro	Descrição
sequência de caracteres	formatos baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados exatamente 24 horas
inteiro	número de milissegundos

Se expressão de string: os formatos aceitos são baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados como sendo exatamente 24 horas.

A string começa com um sinal opcional, indicado pelo símbolo ASCII negativo ou positivo. Se negativo, todo o período é negado. A letra ASCII "P" é a próxima em maiúsculas ou minúsculas. Há então quatro seções, cada uma consistindo de um número e um sufixo. As seções têm sufixos em ASCII de "D", "H", "M" e "S" para dias, horas, minutos e segundos, aceitos em maiúsculas ou minúsculas. Os sufixos devem ocorrer em ordem. A letra ASCII "T" deve ocorrer antes da primeira ocorrência, se houver, de uma hora, minuto ou segunda seção. Pelo menos uma das quatro seções deve estar presente, e se "T" estiver presente, deve haver pelo menos uma seção após o "T". A parte do número de cada seção deve consistir em um ou mais dígitos ASCII. O número pode ser prefixado pelo símbolo ASCII negativo ou positivo. O número de dias, horas e minutos que devem ser analisados. O número de segundos deve ser analisado juntamente com a fração opcional. O ponto decimal pode ser um ponto ou uma vírgula. A parte fracional pode ter de zero a nove dígitos.

Assinaturas e tipo retornado

toDuration(<string>)

toDuration(<integer>)

Retorna uma duração.

Exemplos

toDuration("PT10H")

Retorna a duração de 10 horas.

toDuration("PT4S")

Retorna a duração de 4s.

toDuration(4000)

Retorna a duração de 4s.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parâmetro	Descrição
sequência de caracteres	converte o valor da string em um inteiro
dateTime	converte a data no número de milissegundos (milissegundos da época)
decimal	converte em um inteiro removendo a parte decimal (exemplo: 1,5 torna-se 1)
booleano	converte o valor booleano como 1 se verdadeiro, 0 se falso

Assinaturas e tipo retornado

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Retorna um número inteiro.

Exemplos

toInteger("4")

Retorna 4.

Sintaxe

Parâmetros

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Parâmetro	Descrição
dateTime	converte a data no formato de data UTC
dateTimeOnly	converte a data no formato de data UTC
duração	converta para o número correspondente de milissegundos como uma string
inteiro	converte para representação em string do valor (1 torna-se "1")
decimal	converte para representação em string do valor (1,5 torna-se "1,5")
booleano	converta o valor booleano como 'true' se verdadeiro, 'false' se falso

Assinaturas e tipo retornado

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Retorna uma string.

Exemplos

toString(4)

Retorna "4".

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

Retorna a representação da string do campo dateOnly fornecido (campo XDM Date), por exemplo "2023-08-18".

toString(toDuration(1520))

Retorna "PT1.52S".