Função dateadd

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 10.4 LTS e superior

Adiciona valueunits a um carimbo de data/hora expr. Esta função é um sinônimo de timestampadd função.

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 ser adicionado ao expr.
  • expr: Uma expressão TIMESTAMP.

Devoluções

UM CARIMBO DE DATA/HORA.

Se value for negativo, é subtraído do expr. Se unit for MONTH, QUARTERou YEAR a parte do dia do resultado será ajustada para resultar em uma data válida.

A função retorna um erro de estouro se o resultado estiver além do intervalo suportado de carimbos de data/hora.

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