適用対象:
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