date_diff 関数

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