次の方法で共有

timestampadd 関数

  • [アーティクル]

適用対象:check marked yes Databricks SQL Databricks Runtime 10.4 LTS 以降

valueunit をタイムスタンプ expr に追加します。

構文

timestampadd(unit, value, expr)

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

引数

  • unit: 測定単位。
  • value: expr に追加する unit の数を含む数値式。
  • expr: TIMESTAMP 式。

戻り値

TIMESTAMP。

value が負の場合、expr から減算されます。 unit が MONTH、QUARTER、または YEAR の場合、結果の day の部分は、有効な date の結果に調整されます。

結果がタイムスタンプのサポートされている範囲を超える場合、関数はオーバーフロー エラーを返します。

例

> 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