Funzione date_add

  • Articolo

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

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

Sintassi

date_add(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 dall'oggetto 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 date_add(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 date_add(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000