DATETIME_ADD

Adiciona um intervalo de tempo específico a uma data ou a uma data e hora.

Exemplos de utilização

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Sintaxe

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Parâmetros

  • datetime_expression: um campo ou uma expressão de data ou de data e hora.
  • integer: um campo ou uma expressão numérica inteira que representa o número de partes a adicionar.
  • part: a unidade de medida de tempo a adicionar. DATETIME_ADD suporta os seguintes valores para 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 ao domingo.
    • ISOWEEK: usa os limites da semana ISO 8601. As semanas ISO começam à segunda-feira.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: usa o limite do ano de numeração de semanas da norma ISO 8601. O limite do ano ISO é a segunda-feira da primeira semana cuja quinta-feira pertence ao ano civil gregoriano correspondente.

Tipo de dados devolvidos

Data e hora

Exemplos

Fórmula de exemplo Resultado
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, 00:00:00

Notas

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

Quando usar as partes MONTH, QUARTER ou YEAR, se a data resultante for no último dia do mês (ou perto dele), DATETIME_ADD devolve o último dia do mês. Isto pode acontecer quando o mês na data resultante tem menos dias do que o mês na data de início.

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