time_diff 函數

適用於： SQL Databricks 執行時 18.3 及以上版本

回傳兩個以 s unit為單位的時間值之間的差值。

Syntax

time_diff(unit, start, end)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR }

論點

• unit：量值單位。
• start：一個起始 時間 表達式。
• end：一個結束 時間 的表達式。

Returns

BIGINT。

如果 start 大於 end 結果為負數。

Examples

> SELECT time_diff(HOUR, TIME'08:00:00', TIME'21:30:00');
  13

> SELECT time_diff(MINUTE, TIME'08:00:00', TIME'08:45:30');
  45

> SELECT time_diff(SECOND, TIME'10:00:00', TIME'10:00:30');
  30

-- Start is greater than end
> SELECT time_diff(HOUR, TIME'21:00:00', TIME'08:00:00');
  -13

相關功能

• date_diff函式
• timestampdiff函式
• TIME 類型