Funções de conversão conversion-functions

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

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Retornar um booleano.

toBool("true")

toBool(1)

Retorna verdadeiro.

toBool("this is not a boolean")

Retorna falso.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Retorna um valor de tipo dateOnly.

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.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Retornar um dateTime.

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.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Retorna um datetime sem considerar o fuso horário.

toDateTimeOnly ("2023-08-18")

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

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Retorna um decimal.

toDecimal("4.0")

Retorna 4.0.

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.

toDuration(<string>)

toDuration(<integer>)

Retorna uma duração.

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.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Retorna um número inteiro.

toInteger("4")

Retorna 4.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Retorna uma string.

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

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: esta página documenta todas as funções de conversão em expressões de jornada do AJO, explicando como transformar valores entre tipos como sequência, inteiro, decimal, booleano, data, data e hora e duração.

Intenções:

• Converter uma cadeia de caracteres ou um inteiro de época em um datetime com reconhecimento de fuso horário usando toDateTime
• Converter uma string ou datetime em um datetime sem fuso horário usando toDateTimeOnly
• Extrair um valor somente de data (dia-mês-ano) de uma string ou datetime usando toDateOnly
• Converter um valor em um inteiro, decimal ou booleano usando toInteger, toDecimal ou toBool
• Serializar qualquer valor para sua representação de cadeia de caracteres usando toString
• Converter uma cadeia de caracteres ou um inteiro de milissegundos em uma duração usando toDuration

Glossário:

• dateTime: um valor datetime que inclui informações de deslocamento de fuso horário (específico do produto)
• dateTimeOnly: um valor datetime sem informações de fuso horário (específico do produto)
• dateOnly: um valor de data que representa o ano-mês-dia sem componente de tempo (específico do produto)
• duração: um período expresso no formato ISO-8601 (por exemplo, PT10H) (específico do produto)
• milissegundos da época: carimbo de data/hora Unix expresso em milissegundos desde 1970-01-01T00:00:00Z

Medidas de Proteção:

• O argumento de fuso horário em toDateTime deve ser uma constante de cadeia de caracteres — referências de campo e expressões dinâmicas não são permitidas
• As entradas de cadeia de caracteres para toDateTime e toDateTimeOnly devem seguir o formato ISO-8601; cadeias de caracteres malformadas retornam nulo sem erro
• toDateTime com um número inteiro de época espera milissegundos; multiplique os carimbos de data/hora baseados em segundos por 1000 antes de passar
• toBool retorna true somente para a sequência exata "true"; sequências como "1", "yes" ou "TRUE" retornam false

Terminologia:

• Nome canônico: Funções de conversão — Acrônimo: none — variantes: funções de fundição de tipo, funções de conversão de tipo
• Sinônimos: “toDateTime” = “converter em datetime com fuso horário”; “toDateTimeOnly” = “converter em datetime sem fuso horário”
• Não confunda: “toDateTime” (sensível ao fuso horário) ≠ “toDateTimeOnly” (sem fuso horário)
• Não confunda: “toDateOnly” (somente data, sem hora) ≠ “toDateTime” (data e hora com fuso horário)

Perguntas frequentes:

• P: Quando devo usar toDateTime x toDateTimeOnly? — Use toDateTime quando as informações de fuso horário forem importantes (por exemplo, agendamento ou comparações entre regiões); use toDateTimeOnly quando apenas a data-hora local for relevante e o fuso horário puder ser ignorado.
• P: Por que toBool("TRUE") retorna falso? — toBool reconhece somente a cadeia de caracteres "true" em minúsculas; todos os outros valores de cadeia de caracteres, incluindo "TRUE" ou "yes", retornam false.
• P: Como converter um carimbo de data/hora Unix em segundos para um dateTime? — Multiplique o valor de segundos por 1000 para obter milissegundos e passe-o para toDateTime, por exemplo, toDateTime(myField * 1000).
• P: O fuso horário em toDateTime pode ser lido de um atributo de perfil? — Não, a ID do fuso horário deve ser uma constante de string; referências de campo e expressões não são compatíveis.
• P: Qual formato toDuration aceita como sequência de caracteres? — Formato de duração ISO-8601, por exemplo, "PT10H" para 10 horas ou "P1DT2H" para 1 dia e 2 horas.