跳到主要内容
版本:Latest-3.2

timediff

功能

返回两个 DATETIME 类型值之间的差值。

语法

TIME TIMEDIFF(DATETIME expr1, DATETIME expr2)`

参数说明

expr1: 结束时间,支持的数据类型为 DATETIME。

expr2: 开始时间,支持的数据类型为 DATETIME。

返回值说明

返回值的数据类型为 TIME 类型。如果日期不存在,则返回 NULL。如果日期为 DATE 类型,则按照该日期的零点进行计算。

示例

SELECT TIMEDIFF(now(),utc_timestamp());
+----------------------------------+
| timediff(now(), utc_timestamp()) |
+----------------------------------+
| 08:00:00 |
+----------------------------------+

SELECT TIMEDIFF('2019-07-11 16:59:30','2019-07-11 16:59:21');
+--------------------------------------------------------+
| timediff('2019-07-11 16:59:30', '2019-07-11 16:59:21') |
+--------------------------------------------------------+
| 00:00:09 |
+--------------------------------------------------------+

SELECT TIMEDIFF('2019-01-01 00:00:00', NULL);
+---------------------------------------+
| timediff('2019-01-01 00:00:00', NULL) |
+---------------------------------------+
| NULL |
+---------------------------------------+