Função dateadd

  • Artigo

Aplica-se a:verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 10.4 LTS e versões posteriores

Adiciona valueunits a um carimbo de data/hora expr. Essa função é sinônimo da função timestampdiff.

Sintaxe

dateadd(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Argumentos

  • unit: uma unidade de medida.
  • value: uma expressão numérica com o número de units a serem adicionados a expr.
  • expr: uma expressão CARIMBO DE DATA/HORA.

Retornos

Um TIMESTAMP.

Se value for negativo, ele será subtraído de expr. Se unit for MONTH, QUARTER ou YEAR, a parte do dia do resultado será ajustada para gerar uma data válida.

A função retornará um erro de estouro se o resultado estiver além do intervalo de carimbos de data/hora com suporte.

Exemplos

> SELECT dateadd(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000