適用対象:
Databricks SQL
Databricks Runtime 13.3 LTS 以上
2つの日付の日数差、または指定された単位の2つのタイムスタンプの差を返します。
構文
date_diff(endDate, startDate)
date_diff(unit, start, end)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY |
WEEK |
MONTH |
QUARTER |
YEAR }
引数
-
endDate:DATE式 で終了。 -
startDate:DATE式 で開始。 -
unit: 測定単位。 -
start:TIMESTAMP式 で開始。 -
end:TIMESTAMP式 で終了。
返品
-
date_diff(endDate, startDate)の場合、startDateからendDateまでの日数を表すのINTEGERです。 -
date_diff(unit, start, end)の場合、startとendの差を表すBIGINTをunit単位で測定します。 この形式は関数の同義語timestampdiff。
開始値が終了値より大きい場合、結果は負となります。
この関数は、UTC に基づいて経過した単位全体をカウントします。DAY は 86400 秒です。
暦月が増加し、暦日と時刻が開始時刻以降になると、1 か月が経過したと見なされます。 週、四半期、年はそこから続きます。
例
> SELECT date_diff(DATE'2009-07-31', DATE'2009-07-30');
1
-- One second shy of a month elapsed
> SELECT date_diff(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 date_diff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
1
-- Start is greater than the end
> SELECT date_diff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
-120