Share via


A timestampadd függvény

A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 10.4 LTS és újabb

S-t ad valueunithozzá egy időbélyeghez expr.

Syntax

timestampadd(unit, value, expr)

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

Argumentumok

  • unit: Mértékegység.
  • value: Numerikus kifejezés, a hozzáfűzendő exprs számmalunit.
  • expr: IDŐBÉLYEG-kifejezés.

Válaszok

IDŐBÉLYEG.

Ha value negatív, akkor a függvény kivonja a expr. Ha unit igen MONTH, QUARTERvagy YEAR az eredmény naprésze érvényes dátumhoz lesz igazítva.

A függvény túlcsordulási hibát ad vissza, ha az eredmény meghaladja az időbélyegek támogatott tartományát.

Példák

> 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