DATETIME_ADD

Adiciona um intervalo de tempo especificado à uma data.

Exemplo de uso

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Sintaxe

DATETIME_ADD(datetime_expression, INTERVAL integer part)

Parâmetros

datetime_expression: uma expressão ou um campo "Data" ou "Data e hora".
integer: campo numérico ou expressão inteira que representa o número de partes a serem adicionadas.
part: unidade de medida de tempo a ser adicionada. DATETIME_ADD aceita os seguintes valores de part:
- MICROSECOND: disponível para campos ou expressões de "Data e hora".
- MILLISECOND: disponível para campos ou expressões de "Data e hora".
- SECOND: disponível para campos ou expressões de "Data e hora".
- MINUTE: disponível para campos ou expressões de "Data e hora".
- HOUR: disponível para campos ou expressões de "Data e hora".
- DAY
- WEEK: esta parte da data começa no domingo.
- ISOWEEK: usa limites da semana ISO 8601. As semanas ISO começam na segunda-feira.
- MONTH
- QUARTER
- YEAR
- ISOYEAR: usa o limite de ano com base na numeração da semana ISO 8601. O limite do ano ISO é a segunda-feira da primeira semana que contém a quinta-feira pertencente ao ano do calendário gregoriano correspondente.

Tipo de dados de retorno

Data e hora

Exemplos

Example formula	Output
`DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)`	25 de janeiro de 2023, 15:40:00
`DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)`	30 de janeiro de 2023, 0:00:00

Observações

Esta função não está disponível para os tipos de data do modo de compatibilidade.

Ao usar as partes MONTH, QUARTER ou YEAR, se a data resultante for o último dia do mês (ou estiver perto dele), DATETIME_ADD vai retornar o último dia do mês. Isso pode acontecer quando o mês na data resultante tem menos dias do que o mês na data inicial.

Por exemplo, se Data = 31 de agosto de 2020, DATETIME_ADD(Date, INTERVAL 1 MONTH) retorna 30 de setembro de 2020.

Recursos relacionados

Isso foi útil?

Como podemos melhorá-lo?