MINUTES_DIFF

描述

计算两个日期时间值之间的分钟差值。结果为 <end_date> 减去 <start_date> 的分钟数。

语法

MINUTES_DIFF(<end_date>, <start_date>)

参数

参数	说明
<end_date>	结束时间，类型可以是 DATE、DATETIME 或 DATETIMEV2
<start_date>	开始时间，类型可以是 DATE、DATETIME 或 DATETIMEV2

返回值

返回类型为 INT，表示两个时间之间的分钟差值。

• 如果 <end_date> 大于 <start_date>，返回正数
• 如果 <end_date> 小于 <start_date>，返回负数

举例

SELECT MINUTES_DIFF('2020-12-25 22:00:00', '2020-12-25 21:00:00');

+----------------------------------------------------------------------------------------------------------+
| minutes_diff(cast('2020-12-25 22:00:00' as DATETIMEV2(0)), cast('2020-12-25 21:00:00' as DATETIMEV2(0))) |
+----------------------------------------------------------------------------------------------------------+
|                                                                                                       60 |
+----------------------------------------------------------------------------------------------------------+

注意：

• 计算只考虑完整的分钟数，秒和毫秒部分会被忽略
• 如果任一输入参数为 NULL，则返回 NULL
• 可以处理跨天、跨月、跨年的时间差计算