Funções de data e hora date-time
As funções de data e hora são usadas para executar operações de data e hora em valores dentro do Journey Optimizer.
Adicionar dias add-days
A função addDays
ajusta uma determinada data por um número especificado de dias, usando valores positivos para incrementar e valores negativos para decrementar.
Sintaxe
{%= addDays(date, number) %}
- Entrada:
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %}
- Saída:
2024-11-11T17:19:51Z
Adicionar horas add-hours
A função addHours
ajusta uma determinada data por um número especificado de horas, usando valores positivos para incrementar e valores negativos para decrementar.
Sintaxe
{%= addHours(date, number) %}
- Entrada:
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %}
- Saída:
2024-11-01T18:19:51Z
Adicionar minutos add-minutes
A função addMinutes
ajusta uma determinada data por um número especificado de minutos, usando valores positivos para incrementar e valores negativos para decrementar
Sintaxe
{%= addMinutes(date, number) %}
- Entrada:
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %}
- Saída:
2024-11-01T18:09:51Z
Adicionar meses add-months
A função addMonths
ajusta uma determinada data por um número especificado de meses, usando valores positivos para incrementar e valores negativos para decrementar.
Sintaxe
{%= addMonths(date, number) %}
- Entrada:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %}
- Saída:
2025-01-01T17:19:51Z
Adicionar segundos add-seconds
O addSeconds
ajusta uma determinada data por um número especificado de segundos, usando valores positivos para incrementar e valores negativos para decrementar.
Sintaxe
{%= addSeconds(date, number) %}
- Entrada:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %}
- Saída:
2024-11-01T17:20:01Z
Adicionar anos add-years
O addYears
ajusta uma determinada data por um número especificado de anos, usando valores positivos para incrementar e valores negativos para diminuir.
Sintaxe
{%= addYears(date, number) %}
- Entrada:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %}
- Saída:
2026-11-01T17:19:51Z
Idade age
A função age
é usada para recuperar a idade de uma determinada data.
Sintaxe
{%= age(datetime) %}
Idade em dias age-days
A função ageInDays
calcula a idade de uma determinada data em dias, ou seja, o número de dias decorridos entre a determinada data e a data atual, negativo para datas futuras e positivo para datas passadas.
Sintaxe
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 (Ásia/Calcutá)
- Entrada:
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%}
- Saída:
5
Idade em meses age-months
A função ageInMonths
calcula a idade de uma determinada data em meses, ou seja, o número de meses decorridos entre a determinada data e a data atual , negativo para datas futuras e positivo para datas passadas.
Sintaxe
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30(Ásia/Calcutá)
- Entrada:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%}
- Saída:
12
Comparar datas compare-dates
A função compareDates
compara a primeira data de entrada com a outra. Retorna 0 se data1 for igual a data2, -1 se data1 for anterior a data2 e 1 se data1 for posterior a data2.
Sintaxe
{%= compareDates(date1, date2) %}
- Entrada:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%}
- Saída:
-1
Converter ZonedDateTime convert-zoned-date-time
A função convertZonedDateTime
converte uma data-hora em um determinado fuso horário.
Sintaxe
{%= convertZonedDateTime(dateTime, timezone) %}
- Entrada:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%}
- Saída:
2019-02-19T11:39+03:30[Asia/Tehran]
Hora atual em milissegundos current-time
A função currentTimeInMillis
é usada para recuperar a hora atual em milissegundos da época.
Sintaxe
{%= currentTimeInMillis() %}
Diferença de data date-diff
A função dateDiff
é usada para recuperar a diferença entre duas datas em número de dias.
Sintaxe
{%= dateDiff(datetime,datetime) %}
Dia do mês day-month
dayOfWeek
retorna o número que representa o dia do mês.
Sintaxe
{%= dayOfMonth(datetime) %}
- Entrada:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %}
- Saída:
5
Dia da semana day-week
A função dayOfWeek
é usada para recuperar o dia da semana.
Sintaxe
{%= dayOfWeek(datetime) %}
Dia do ano day-year
A função dayOfYear
é usada para recuperar o dia do ano.
Sintaxe
{%= dayOfYear(datetime) %}
Diferença em segundos diff-seconds
A função diffInSeconds
retorna a diferença entre duas datas em termos de segundos.
Sintaxe
{%= diffInSeconds(endDate, startDate) %}
- Entrada:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%}
- Saída:
50
Extrair horas extract-hours
A função extractHours
extrai o componente de hora de um determinado carimbo de data/hora.
Sintaxe
{%= extractHours(date) %}
- Entrada:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
17
Extrair minutos extract-minutes
A função extractMinutes
extrai o componente de minuto de um carimbo de data/hora especificado.
Sintaxe
{%= extractMinutes(date) %}
- Entrada:
{%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
19
Extrair meses extract-months
A função extractMonth
extrai o componente de mês de um determinado carimbo de data/hora.
Sintaxe
{%= extractMonths(date) %}
- Entrada:
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
11
Extrair segundos extract-seconds
A função extractSeconds
extrai o segundo componente de um determinado carimbo de data/hora.
Sintaxe
{%= extractSeconds(date) %}
- Entrada:
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
51
Formatar data format-date
A função formatDate
é usada para formatar um valor de data e hora. O formato deve ser um padrão DateTimeFormat do Java válido.
Sintaxe
{%= formatDate(datetime, format) %}
Onde a primeira string é o atributo de data e o segundo valor é como você gostaria que a data fosse convertida e exibida.
Exemplo
A operação a seguir retornará a data no seguinte formato: MM/DD/AA.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
Formatar data com suporte local format-date-locale
A função formatDate
é usada para formatar um valor de data e hora em sua representação sensível a idioma correspondente, ou seja, em um local desejado. O formato deve ser um padrão DateTimeFormat do Java válido.
Sintaxe
{%= formatDate(datetime, format, locale) %}
Onde a primeira string é o atributo de data, o segundo valor é como você gostaria que a data fosse convertida e exibida, e o terceiro valor representa o local no formato de string.
Exemplo
A operação a seguir retornará a data no seguinte formato: MM/dd/AA e localidade FRANÇA.
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}
Obter CurrentZonedDateTime get-current-zoned-date-time
A função getCurrentZonedDateTime
retorna a data e a hora atuais com informações de fuso horário.
Sintaxe
{%= getCurrentZonedDateTime() %}
- Entrada:
{%= getCurrentZonedDateTime() %}
- Saída:
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
Diferença em horas hours-difference
A função diffInHours
retorna a diferença entre duas datas em termos de horas.
Sintaxe
{%= diffInHours(endDate, startDate) %}
- Entrada:
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%}
- Saída:
10
Diferença em minutos diff-minutes
A função diffInMinutes
é usada para retornar a diferença entre duas datas em termos de minutos.
Sintaxe
{%= diffInMinutes(endDate, startDate) %}
- Entrada:
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%}
- Saída:
60
Diferença em meses months-difference
A função diffInMonths
retorna a diferença entre duas datas em termos de meses.
Sintaxe
{%= diffInMonths(endDate, startDate) %}
- Entrada:
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%}
- Saída:
3
Definir dias set-days
A função setDays
é usada para definir o dia do mês para a data-hora especificada.
Sintaxe
{%= setDays(datetime, day) %}
Definir horas set-hours
A função setHours
é usada para definir a hora da data-hora.
Sintaxe
{%= setHours(datetime, hour) %}
Para data hora to-date-time
A função ToDateTime
converte a cadeia de caracteres em data. Retorna a data da época como saída para entrada inválida.
Sintaxe
{%= toDateTime(string, string) %}
- Entrada:
{%=toDateTime("2024-11-01T17:19:51Z")%}
- Saída:
2024-11-01T17:19:51Z
Para UTC to-utc
A função toUTC
é usada para converter um datetime em UTC.
Sintaxe
{%= toUTC(datetime) %}
Vincular ao início do dia truncate-day
A função truncateToStartOfDay
é usada para modificar uma determinada data-hora definindo-a como o início do dia com a hora definida como 00:00.
Sintaxe
{%= truncateToStartOfDay(date) %}
- Entrada:
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %}
- Saída:
2024-11-01T00:00Z
truncateToStartOfQuarter truncate-quarter
A função truncateToStartOfQuarter
é usada para truncar uma data-hora para o primeiro dia de seu trimestre (por exemplo, 1º de janeiro, 1º de abril, 1º de julho, 1º de outubro) em 00:00.
Sintaxe
{%= truncateToStartOfQuarter(dateTime) %}
- Entrada:
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
2024-10-01T00:00Z
truncateToStartOfWeek truncate-week
A função truncateToStartOfWeek
modifica uma determinada data-hora definindo-a para o início da semana (segunda-feira às 00:00).
Sintaxe
{%= truncateToStartOfWeek(dateTime) %}
- Entrada:
truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday
- Saída:
2024-11-18T00:00Z // monday
truncateToStartOfYear truncate-year
A função truncateToStartOfYear
é usada para modificar uma determinada data-hora, truncando-a para o primeiro dia do ano (1º de janeiro) em 00:00.
Sintaxe
{%= truncateToStartOfYear(dateTime) %}
- Entrada:
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%}
- Saída:
2024-01-01T00:00Z
Semana do ano week-of-year
A função weekOfYear
é usada para recuperar a semana do ano.
Sintaxe
{%= weekOfYear(datetime) %}
Diferença em anos diff-years
A função diffInYears
é usada para retornar a diferença entre duas datas em termos de anos.
Sintaxe
{%= diffInYears(endDate, startDate) %}: int
- Entrada:
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%}
- Saída:
5