DATETIME_ADD

Adiciona um intervalo de tempo especificado a uma data ou data e hora.

Exemplo de uso

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Sintaxe

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Parâmetros

  • datetime_expression: campo ou expressão de "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

Exemplo de fórmula Saída
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

Essa 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.