TIMESTAMPDIFF 返回结果与预期不符是因为它按日历单位逐级计算整数倍差值，不考虑小数部分；例如跨23小时返回0，跨1天返回1，且对跨月、闰年等边界有日历语义处理。
为什么 TIMESTAMPDIFF 返回结果和预期不符？
常见现象是用 TIMESTAMPDIFF(HOUR, start_time, end_time) 算出 23 小时，但实际只差 1 天；或跨月计算时结果“少了一天”。这是因为 TIMESTAMPDIFF 不是简单做时间戳相减再换算，而是按日历单位逐级计算：先算完整年数，再算剩余月份中的完整月数，再算剩余天数……依此类推。它不考虑小数部分，只返回整数倍的单位数量。
所以 TIMESTAMPDIFF(DAY, '2024-01-01 23:59:59', '2024-01-02 00:00:00') 返回 1（跨了完整一天），而 TIMESTAMPDIFF(HOUR, '2024-01-01 23:59:59', '2024-01-02 00:00:00') 返回 0（没满一整小时）。
- 单位参数必须是大写：如
SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR - 顺序不能反：
TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)中，datetime_expr1是起点，datetime_expr2是终点；反了会得负数 - 输入必须是合法的
DATETIME或TIMESTAMP值，字符串需符合'Y-m-d H:i:s'格式，否则返回NULL
什么时候该用 TIMESTAMPDIFF，而不是 UNIX_TIMESTAMP 相减？
当你需要“日历语义”的差值时选 TIMESTAMPDIFF：比如“用户注册到今天过了几个月”，“订单创建到发货隔了几周”。它能正确处理 2 月 28/29 日、闰年、30/31 日等边界。
当你需要“精确秒级差值”或后续做除法/平均值时，用 UNIX_TIMESTAMP(end) - UNIX_TIMESTAMP(start) 更稳妥——它返回真实经过的秒数，无歧义。
-
TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-28')→1（因为 1 月 31 日到 2 月 31 日不存在，但已跨进 2 月，算 1 个月） -
UNIX_TIMESTAMP('2023-02-28') - UNIX_TIMESTAMP('2023-01-31')→2505600秒 ≈ 29 天，更贴近物理时间跨度 - 跨时区场景下，
TIMESTAMPDIFF按会话时区解释输入值，而UNIX_TIMESTAMP总转为 UTC 秒数，行为更可预测
TIMESTAMPDIFF 在 JOIN 或 WHERE 中的性能要注意什么？
它本身是标量函数，不会阻止索引使用——前提是参数是**列 + 常量**，不是列与列之间运算。例如 WHERE TIMESTAMPDIFF(DAY, created_at, NOW()) > 30 可走 created_at 索引；但 WHERE TIMESTAMPDIFF(DAY, created_at, updated_at) > 30 无法利用索引，MySQL 得全表扫描。
- 避免在 WHERE 中对两个字段同时调用
TIMESTAMPDIFF，改用范围条件重写：updated_at > DATE_ADD(created_at, INTERVAL 30 DAY)可命中索引 - 如果频繁按“X 天前”筛选，考虑加生成列 + 索引：
ALTER TABLE orders ADD days_since_created INT AS (TIMESTAMPDIFF(DAY, created_at, CURDATE())) STORED，再建索引 -
TIMESTAMPDIFF不支持函数索引（MySQL 5.7 不支持，8.0+ 支持但仅限于确定性函数），别指望给它直接建索引
跨零点/跨月计算时最容易忽略的细节
很多人以为 TIMESTAMPDIFF(DAY, a, b) 就等于 (b - a) 的天数取整，但其实它会“截断到日粒度再比对”。例如：
SELECT TIMESTAMPDIFF(DAY, '2024-03-15 23:59:59', '2024-03-16 00:00:00'), -- 返回 1 TIMESTAMPDIFF(DAY, '2024-03-15 00:00:00', '2024-03-16 23:59:59'); -- 也返回 1（不是 1.99）
也就是说，只要终点日期比起点日期的“日部分”大，就算作 1 天，不管具体时分秒。
- 想获取带小数的天数差？别用
TIMESTAMPDIFF，改用(UNIX_TIMESTAMP(b) - UNIX_TIMESTAMP(a)) / 86400.0 - 计算“是否满 N 天”逻辑（如会员有效期），用
TIMESTAMPDIFF是安全的；但计算“剩余多少小时”，应优先用TIMESTAMPDIFF(HOUR, NOW(), expire_time)并确认是否接受“向下取整” - 注意
WEEK单位按默认周起始（周日），若业务按周一算周，得先用DATE_SUB(created_at, INTERVAL WEEKDAY(created_at) DAY)对齐再算
实际用的时候，先想清楚你要的是“日历计数”还是“物理时长”——选错函数，后面所有统计都偏了。
