適用対象:
Databricks SQL Databricks Runtime 10.4 LTS 以降
unit で測定された 2 つのタイムスタンプの差を返します。
構文
timestampdiff(unit, start, end)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY |
WEEK |
MONTH |
QUARTER |
YEAR }
引数
-
unit: 測定単位。 -
start:TIMESTAMP式 で開始。 -
end:TIMESTAMP式 で終了。
返品
BIGINT です。
start が end より大きい場合、結果は負になります。
この関数は、UTC に基づいて経過した単位全体をカウントします。DAY は 86400 秒です。
暦月が増加し、暦日と時刻が開始時刻以降になると、1 か月が経過したと見なされます。 週、四半期、年はそこから続きます。
例
-- One second shy of a month elapsed
> SELECT timestampdiff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 11:59:59');
0
-- One month has passed even though its' not end of the month yet because day and time line up.
> SELECT timestampdiff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
1
-- Start is greater than the end
> SELECT timestampdiff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
-120