MariaDB TIMEDIFF() 函数使用指南

在 MariaDB 中，TIMEDIFF() 是一个内置函数，它返回两个时间值或日期时间值之间的差值。

MariaDB TIMEDIFF() 语法

这是 MariaDB TIMEDIFF() 函数的语法：

TIMEDIFF(time1, time2)

参数

time1
必需的。一个时间或者日期时间表达式。
time2
必需的。另一个时间或者日期时间表达式。

如果您提供了错误数量的参数，MariaDB 将报告一个错误：ERROR 1582 (42000): Incorrect parameter count in the call to native function 'TIMEDIFF'。

返回值

MariaDB TIMEDIFF() 函数返回两个时间值或日期时间值之间的差值，它返回一个 HH:MM:SS 格式的时间值。

如果指定的表达式不是一个合法的时间或者日期时间，TIMEDIFF() 函数将返回 NULL。

如果参数为 NULL，TIMEDIFF() 函数将返回 NULL。

MariaDB TIMEDIFF() 示例

示例 1 - 时间值

SELECT TIMEDIFF('12:12:12', '12:10:10');

输出：

+----------------------------------+
| TIMEDIFF('12:12:12', '12:10:10') |
+----------------------------------+
| 00:02:02                         |
+----------------------------------+

示例 2 - 日期时间值

SELECT TIMEDIFF('2023-01-28 12:12:12', '2023-01-28 10:11:12');

输出：

+--------------------------------------------------------+
| TIMEDIFF('2023-01-28 12:12:12', '2023-01-28 10:11:12') |
+--------------------------------------------------------+
| 02:01:00                                               |
+--------------------------------------------------------+

示例 3 - 当前日期时间

SELECT TIMEDIFF(NOW(), '2023-01-01 10:10:10');

输出：

+----------------------------------------+
| TIMEDIFF(NOW(), '2023-01-01 10:10:10') |
+----------------------------------------+
| 267:29:26                              |
+----------------------------------------+

这里，我们使用了 NOW() 函数获取当前的时刻。除此之外，您还可以使用 CURDATE(), CURRENT_DATE(), SYSDATE()。

结论

在 MariaDB 中，TIMEDIFF() 是一个内置函数，它返回两个时间值或日期时间值之间的差值。