Condividi tramite

Funzione dateadd

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive

Aggiunge value units a un timestamp expr. Questa funzione è un sinonimo di funzione timestampadd.

Sintassi

dateadd(unit, value, expr)

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

Argomenti

  • unit: unità di misura.
  • value: espressione numerica con il numero di units da aggiungere a expr.
  • expr: espressione TIMESTAMP.

Valori restituiti

A TIMESTAMP.

Se value è negativo, viene sottratto da expr. Se unit è MONTH, QUARTERo YEAR la parte del giorno del risultato verrà modificata in modo da ottenere una data valida.

La funzione restituisce un errore di overflow se il risultato supera l'intervallo di timestamp supportato.

Esempi

> 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