Condividi tramite

Funzione timestampadd

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

Sintassi

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