date_diff函式

適用於:核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本

回傳兩個日期(天數)或指定單位中兩個時間戳之間的差值。

語法

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),代表 INTEGER 從 startDate 到 endDate的天數。
  • 對於 ,a BIGINT 代表 和 end 之間的差start值,測量單位為 unitdate_diff(unit, start, end)s。 這個形式是功能(function)的timestampdiff同義詞。

若起始值大於終值,則結果為負。

函式會根據 UTCDAY 86400秒計算整個經過的單位。

當行事曆月份增加且日曆日和時間等於或大於開始時,就會將一個月視為經過。 之後的幾周、季度和年份。

範例

> 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