mysql TIMESTAMPDIFF函数用法
该函数用于计算两个日期或日期时间表达式之间的差值 。
语法：TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)
unit（时间单位）：
- MICROSECOND（微秒）
- SECOND（秒）
- MINUTE（分钟）
- HOUR（小时）
- DAY（天）
- WEEK（周）
- MONTH（月）
- QUARTER（季度）
- YEAR（年）
使用示例
以下是一些常见的使用示例，帮助您理解该函数的实际应用：
场景描述SQL 示例返回值说明
| 计算两个日期之间的天数差 | SELECT TIMESTAMPDIFF(DAY, '2023-01-01', '2023-01-10'); | 返回 9 |
| 计算两个日期时间之间的小时差 | SELECT TIMESTAMPDIFF(HOUR, '2023-01-01 12:00:00', '2023-01-01 18:00:00'); | 返回 6 |
| 计算年龄（年） | SELECT TIMESTAMPDIFF(YEAR, '1990-05-15', CURDATE()); | 返回从出生日期到当前日期的整年数 |
| 计算月份差 | SELECT TIMESTAMPDIFF(MONTH, '2012-10-01', '2013-01-13'); | 返回 3 |
| 结束时间早于开始时间 | SELECT TIMESTAMPDIFF(DAY, '2023-01-10', '2023-01-01'); | 返回 -9 |
注意事项
结果取整：函数返回的是整数差值。例如，计算两个日期相差不到一个月时，MONTH单位会返回 0
单位边界计算：对于 MONTH、YEAR等大单位，计算基于跨越的单位边界，而非精确的天数。例如，TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-01')会返回 1，因为跨过了1月到2月这个“月”的边界，尽管实际只相差1天
NULL 值处理：如果任何一个参数为 NULL，函数将返回 NULL
与 DATEDIFF的区别：MySQL 中的 DATEDIFF函数仅用于计算两个日期之间的天数差（忽略时间部分），且参数顺序是 (end_date, start_date)，与 TIMESTAMPDIFF相反
实际应用场景
用户行为分析：计算用户最后一次登录到现在的时长（如秒、天），用于判断用户活跃度
业务时长计算：计算工单处理、任务执行等业务的持续时间（如分钟、小时）
报表生成：在数据分析和报表中，计算特定时间段内的间隔
TIMESTAMPDIFF()是处理日期和时间间隔计算的利器，正确理解其参数和返回值特性，可以有效应对各种时间差计算需求。