Funções de data date-functions
As funções de data permitem manipular e trabalhar com valores de data e hora nas expressões de jornada. Essas funções são essenciais para condições baseadas em tempo, programação e cálculos temporais nas jornadas do cliente.
Use funções de data quando precisar:
- Obtenha a hora ou data atual com a manipulação de fuso horário específica (now, nowWithDelta, currentTimeInMillis)
- Verifique se uma data está em um intervalo de tempo específico (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, inNextMonths, inNextYears)
- Modificar componentes de data e hora (setHours, setDays, updateTimeZone)
- Realizar cálculos e comparações com base no tempo
- Converter entre diferentes formatos de hora e representações
As funções de data fornecem controle preciso sobre a lógica temporal, permitindo que você crie caminhos de jornadas com detecção de hora e condições que respondam a cronogramas e cronogramas específicos.
currentTimeInMillis currentTimeInMillis
Retorna a hora atual em milissegundos da época.
currentTimeInMillis()currentTimeInMillis()
Retorna um inteiro.
currentTimeInMillis()
Retorna "1544712617131".
inLastDays inLastDays
Retorna verdadeiro se um determinado dateTime estiver entre agora e agora - dias delta.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inLastDays(<dateTime>,<integer>)
Retorna um valor booleano.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
inLastHours inLastHours
Retorna verdadeiro se a data e hora especificadas estiverem entre agora e agora - delta horas.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
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 inLastMonths
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora - meses delta.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inLastMonths(<dateTime>,<integer>)
Retorna um valor booleano.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
inLastYears inLastYears
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora - anos delta.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inLastYears(<dateTime>,<integer>)
Retorna um valor booleano.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
inNextDays inNextDays
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora + dias delta.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inNextDays(<dateTime>,<integer>)
Retorna um valor booleano.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
inNextHours inNextHours
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora + horas delta.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inNextHours(<dateTime>,<integer>)
Retorna um valor booleano.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
inNextMonths inNextMonths
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora + meses delta.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inNextMonths(<dateTime>,<integer>)
Retorna um valor booleano.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Retorna verdadeiro.
inNextYears inNextYears
Retorna verdadeiro se uma determinada data ou dateTime estiver entre agora e agora + anos delta.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| delta | inteiro |
inNextYears(<dateTime>,<integer>)
Retorna um valor booleano.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Retorna verdadeiro.
now now
Retorna a data atual no formato de data e hora. Para obter mais informações sobre tipos de dados, consulte esta página.
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parâmetro | Descrição |
| sequência de caracteres | Identificador de fuso horário (opcional) |
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 nowWithDelta
Retorna o datetime atual incluindo um deslocamento. Se uma ID de fuso horário for especificada, o deslocamento de fuso horário será aplicado. Para obter mais informações sobre tipos de dados, consulte esta página.
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parâmetro | Descrição |
| delta | valor inteiro positivo ou negativo |
| parte de data | anos, meses, dias, horas, minutos ou segundos como uma string |
| id do fuso horário | representação da string do valor do fuso horário. Para obter mais informações, consulte Tipos de dados. A ID do fuso horário deve ser uma constante de sequência. Não pode ser uma referência de campo nem uma expressão. |
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.
setHours setHours
Define apenas as horas de uma data e hora ou data e hora. Por exemplo, se você quiser aguardar até uma determinada hora amanhã, poderá forçar a hora.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| data hora sem considerar o fuso horário | dateTimeOnly |
| horas | inteiro |
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. :XY Se a avaliação ocorrer às 2:45 AM, a hora retornada será 20:45 PM.
setDays setDays
Define apenas o dia de uma data e hora ou data e hora. Por exemplo, se você quiser aguardar até um determinado dia do mês, poderá forçar o dia.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parâmetro | Tipo |
| data e hora | dateTime |
| data hora sem considerar o fuso horário | dateTimeOnly |
| dias | inteiro |
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)
updateTimeZone updateTimeZone
Retorna uma nova data e hora, com um novo fuso horário no mesmo instante.
updateTimeZone(<parameters>)- 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.