date_diff 函数

  • 项目

适用于：check marked yesDatabricks SQL check marked yes Databricks Runtime 13.2 及更高版本

返回两个以 unit 为单位的时间戳之间的差异。 date_diff (timestamp) 是 timestampdiff 函数的同义词。

语法

date_diff(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 秒。

如果日历月份递增并且日历日期和时间等于或大于开始值时，则认为一个月已消逝。 从该时间开始消逝的周数、季数和年数。

示例

-- 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