適用於:
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