Adicionar meses
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) %}
Exemplo
- Entrada:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Saída:
2025-01-01T17:19:51Z
Adicionar segundos
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) %}
Exemplo
- Entrada:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Saída:
2024-11-01T17:20:01Z
Adicionar anos
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) %}
Exemplo
- Entrada:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Saída:
2026-11-01T17:19:51Z
Idade
A função age é usada para recuperar a idade de uma determinada data.
Sintaxe
{%= age(datetime) %}
Idade em dias
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) %}
Exemplo
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
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) %}
Exemplo
currentDate = 2025-01-07T12:22:46.993748+05:30(Ásia/Calcutá)
- Entrada:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Saída:
12
Comparar datas
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) %}
Exemplo
- Entrada:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Saída:
-1
Converter ZonedDateTime
A função convertZonedDateTime converte uma data-hora em um determinado fuso horário.
Sintaxe
{%= convertZonedDateTime(dateTime, timezone) %}
Exemplo
- Entrada:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Saída:
2019-02-19T11:39+03:30[Asia/Tehran]
Hora atual em milissegundos
A função currentTimeInMillis é usada para recuperar a hora atual em milissegundos da época.
Sintaxe
{%= currentTimeInMillis() %}
Diferença de data
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
dayOfWeek retorna o número que representa o dia do mês.
Sintaxe
{%= dayOfMonth(datetime) %}
Exemplo
- Entrada:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Saída:
5
Dia da semana
A função dayOfWeek é usada para recuperar o dia da semana.
Sintaxe
{%= dayOfWeek(datetime) %}
Dia do ano
A função dayOfYear é usada para recuperar o dia do ano.
Sintaxe
{%= dayOfYear(datetime) %}
Diferença em segundos
A função diffInSeconds retorna a diferença entre duas datas em termos de segundos.
Sintaxe
{%= diffInSeconds(endDate, startDate) %}
Exemplo
- Entrada:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Saída:
50
Extrair horas
A função extractHours extrai o componente de hora de um determinado carimbo de data/hora.
Sintaxe
{%= extractHours(date) %}
Exemplo
- Entrada:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
17
Extrair minutos
A função extractMinutes extrai o componente de minuto de um carimbo de data/hora especificado.
Sintaxe
{%= extractMinutes(date) %}
Exemplo
- Entrada:
{%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
19
