Funções de data date-functions

currentTimeInMillis()

Retorna um inteiro.

currentTimeInMillis()

Retorna “1544712617131”.

inLastDays(<dateTime>,<integer>)

Retorna um valor booleano.

inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inLastHours(<dateTime>,<integer>)

Retorna um valor booleano.

inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inLastHours(@event{MyEvent.timestamp}, 4)

Retorna verdadeiro.

inLastMonths(<dateTime>,<integer>)

Retorna um valor booleano.

inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inLastYears(<dateTime>,<integer>)

Retorna um valor booleano.

inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inNextDays(<dateTime>,<integer>)

Retorna um valor booleano.

inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inNextHours(<dateTime>,<integer>)

Retorna um valor booleano.

inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

inNextMonths(<dateTime>,<integer>)

Retorna um valor booleano.

inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)

Retorna verdadeiro.

inNextYears(<dateTime>,<integer>)

Retorna um valor booleano.

inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)

Retorna verdadeiro.

now()

now("<timeZone id>")

Retorna dateTime.

now()

Retorna 2023-06-03T06:30Z.

toString(now())

Retorna “2023-06-03T06:30Z”

now("Europe/Paris")

Retorna 2023-06-03T08:30+02:00.

nowWithDelta(<delta>,<date part>

nowWithDelta(<delta>,<date part>,"<timeZone id>")

Retorna dateTime.

nowWithDelta(-2, "hours")

nowWithDelta(-2, "hours", "Europe/Paris")

Retorna dateTime exatamente 2 horas atrás.

nowWithDelta(1, "months", "Asia/Tokyo")

Quando avaliado em 31/01/2026, retorna 28/02/2026; quando avaliado em 31/05/2026, retorna 30/06/2026…

nowWithDelta() usa aritmética de mês de calendário. Se o mês de destino tiver menos dias que o dia do mês atual, o resultado será normalizado para o último dia válido desse mês. A função não se estende para o mês seguinte.

setHours(<dateTime>,<hours>)

Retorna um datetime.

setHours(<dateTimeOnly>,<hours>)

Retorna uma data e hora sem considerar o fuso horário.

setHours(toDateTime('2023-12-12T01:11:00Z'), 4)

Retorna 2023-12-12T04:11:00Z.

setHours(nowWithDelta(1, "days"), 20)

Retorna amanhã às 20h00, sendo XY os minutos no momento da avaliação de hora atual. :XYSe a avaliação ocorrer às 2:45 AM, a hora retornada será 20:45 PM.

setDays(<dateTime>,<days>)

Retorna um datetime.

setDays(<dateTimeOnly>,<days>)

Retorna uma data e hora sem considerar o fuso horário.

setDays(toDateTime('2023-12-12T01:11:00Z'), 25)

Retorna 2023-12-25T01:11:00Z.

setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)

• id do fuso horário: string
• dateTime

updateTimeZone(<dateTime>,<timeZone id>)

Retorna um datetime.

updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))

Retorna 28/08/2023:15:30.123+02:00.

updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")

Se o valor do campo de carimbo de data/hora for 2021-11-16T16:55:12.939318+01:00, a função retornará 2021-11-17T02:55:12.942115+11:00.

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 data e hora disponíveis nas expressões do AJO jornada, abordando como obter a hora atual, verificar se uma data se enquadra em uma janela de tempo relativa e modificar componentes de data/hora.

Intenções:

• Obter o datetime atual (com fuso horário opcional) usando now ou nowWithDelta
• Recuperar a hora atual como um inteiro da época usando currentTimeInMillis
• Verifique se um datetime está nos últimos N dias, horas, meses ou anos usando inLastDays, inLastHours, inLastMonths, inLastYears
• Verifique se um datetime está nos próximos N dias, horas, meses ou anos usando inNextDays, inNextHours, inNextMonths, inNextYears
• Forçar uma hora ou dia específico do mês em um valor datetime usando setHours ou setDays
• Converta um datetime em um fuso horário diferente, preservando o mesmo instante usando updateTimeZone

Glossário:

• dateTime: um valor date-time que inclui informações de deslocamento de fuso horário (específico do produto)
• dateTimeOnly: um valor date-time sem informações de fuso horário (específico do produto)
• milissegundos da época: um número inteiro que representa o número de milissegundos decorridos desde 1970-01-01T00:00:00Z
• delta: um deslocamento inteiro (positivo ou negativo) usado com nowWithDelta para deslocar a hora atual por um número de anos, meses, dias, horas, minutos ou segundos

Medidas de Proteção:

• now() está disponível somente em expressões jornada; para personalização de email, use getCurrentZonedDateTime()
• A ID do fuso horário em nowWithDelta deve ser uma constante de cadeia de caracteres — não há suporte para referências de campo e expressões dinâmicas
• A ID do fuso horário em updateTimeZone deve ser uma constante de cadeia de caracteres

Terminologia:

• Nome canônico: Funções de data — Acrônimo: none — variantes: funções de data e hora, funções temporais
• Sinônimos: “now()” = “current datetime”; “currentTimeInMillis()” = “current epoch miliseconds”
• Não confunda: “inLastDays” (retroage no tempo) ≠ “inNextDays” (retroage no tempo)
• Não confunda: “setHours” (substitui o componente de hora) ≠ “nowWithDelta” (desloca a hora atual)
• Não confunda: “updateTimeZone” (mesmo instante, representação de fuso horário diferente) ≠ “setHours” (altera o valor de tempo em si)

Perguntas frequentes:

• P: Posso usar now() no conteúdo de personalização de email? — Não, now() está disponível somente em expressões de jornada. Use getCurrentZonedDateTime() para personalização de email.
• P: Como verificar se um evento aconteceu nas últimas 24 horas? — Use inLastHours(@event{MyEvent.timestamp}, 24).
• P: Como faço para obter a diferença de tempo atual de 2 horas no passado? — Use nowWithDelta(-2, "hours").
• P: O que updateTimeZone faz de diferente de setHours? — updateTimeZone mantém o mesmo instante de tempo, mas o expressa em um fuso horário diferente, enquanto setHours altera o componente de hora do valor datetime.
• P: O parâmetro de fuso horário em nowWithDelta pode ser um campo de perfil? — Não, a ID do fuso horário deve ser uma constante de cadeia de caracteres; não há suporte para referências de campo.
• P: O que acontece quando nowWithDelta() é usado com meses e a data atual é uma data de fim de mês? — A função usa aritmética de mês-calendário e normaliza o resultado para o último dia válido do mês de destino. Por exemplo, adicionar 1 mês a 31 de janeiro retorna 28 de fevereiro (não 3 de março).