MINUTES_DIFF
更新时间:2025-10-17
描述
计算两个日期时间值之间的分钟差值。结果为 <end_date>
减去 <start_date>
的分钟数。
语法
SQL
1MINUTES_DIFF(<end_date>, <start_date>)
参数
参数 | 说明 |
---|---|
<end_date> |
结束时间,类型可以是 DATE、DATETIME 或 DATETIMEV2 |
<start_date> |
开始时间,类型可以是 DATE、DATETIME 或 DATETIMEV2 |
返回值
返回类型为 INT,表示两个时间之间的分钟差值。
- 如果
<end_date>
大于<start_date>
,返回正数 - 如果
<end_date>
小于<start_date>
,返回负数
举例
SQL
1SELECT MINUTES_DIFF('2020-12-25 22:00:00', '2020-12-25 21:00:00');
Text
1+----------------------------------------------------------------------------------------------------------+
2| minutes_diff(cast('2020-12-25 22:00:00' as DATETIMEV2(0)), cast('2020-12-25 21:00:00' as DATETIMEV2(0))) |
3+----------------------------------------------------------------------------------------------------------+
4| 60 |
5+----------------------------------------------------------------------------------------------------------+
注意:
- 计算只考虑完整的分钟数,秒和毫秒部分会被忽略
- 如果任一输入参数为 NULL,则返回 NULL
- 可以处理跨天、跨月、跨年的时间差计算