TIMESTAMPDIFF返回0或负数的主因是参数顺序颠倒：第二个参数须为较早时间、第三个为较晚时间，反则得负值；若时间相等或精度截断（如仅日期无时分秒）则得0。
为什么TIMESTAMPDIFF返回结果总是0或负数
常见原因是参数顺序写反了：TIMESTAMPDIFF要求第一个参数是单位（如 SECOND、MINUTE），第二个是**较早时间**，第三个是**较晚时间**。如果把大小顺序颠倒，结果就是负数；如果两个时间相等或精度被截断（比如只传了日期没传时分秒），就可能得0。
实操建议：
- 始终用
SELECT TIMESTAMPDIFF(UNIT, start_time, end_time);模式，别凭直觉调换后两个参数 - 确认字段类型：若列是
DATETIME或TIMESTAMP，但值只存了'2024-01-01'（隐式转为'2024-01-01 00:00:00'），计算小时差时会丢失精度 - 用
SELECT start_time, end_time FROM ...先查出原始值，肉眼核对是否真有时间差
TIMESTAMPDIFF支持哪些时间单位？有什么陷阱
支持的单位包括：FRAC_SECOND（微秒，仅 MySQL 8.0.28+）、SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR。注意：WEEK 按7天算，不考虑周几起始；MONTH 和 YEAR 是“日历月/年”差，不是简单除法。
例如：TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-28') 返回 1，但 TIMESTAMPDIFF(DAY, '2023-01-31', '2023-02-28') 返回 28 —— 这不是bug，是设计如此。
实操建议：
- 要算“整月”差异（比如合同有效期），用
MONTH单位；要算“自然天数”，必须用DAY，不能用MONTH * 30 -
FRAC_SECOND需要字段带微秒精度（定义为TIMESTAMP(6)或DATETIME(6)），否则返回0 - 避免混用单位：比如用
HOUR算跨多天的时间差，不如直接用DAY+HOUR分开算更可控
如何处理NULL或非法时间导致计算失败
TIMESTAMPDIFF遇到 NULL 参数时直接返回 NULL，不报错；但如果传入非法时间（如 '2023-02-30'），在严格模式下会报错 Incorrect datetime value。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
实操建议：
- 加
WHERE start_time IS NOT NULL AND end_time IS NOT NULL过滤空值，或用IFNULL()包一层：IFNULL(TIMESTAMPDIFF(SECOND, a, b), -1) - 用
STR_TO_DATE()校验并标准化字符串时间：STR_TO_DATE('2023/01/01', '%Y/%m/%d')返回NULL而不是错误，可配合COALESCEfallback - 建表时尽量用
TIMESTAMP或DATETIME类型存时间，别用VARCHAR存格式混乱的字符串
性能和时区问题怎么影响TIMESTAMPDIFF结果
TIMESTAMPDIFF内部按服务器当前时区做计算。如果字段是 TIMESTAMP 类型，值存储为UTC，读取时自动转为会话时区；而 DATETIME 是“字面量”，不自动转换。两者混用会导致差值偏差。
例如：服务器时区是 UTC+8，存入 TIMESTAMP 值 '2023-01-01 00:00:00' 实际存的是 UTC 时间 '2022-12-31 16:00:00'。若与一个 DATETIME 值比较，结果可能不符合预期。
实操建议：
- 统一使用
TIMESTAMP类型 + 显式设置会话时区（SET time_zone = '+00:00';），或全部用DATETIME并确保应用层已转为同一时区再入库 - 在 WHERE 或 ORDER BY 中大量使用
TIMESTAMPDIFF会影响索引使用——它无法走索引，应尽量提前计算好差值存为冗余字段 - 测试时用
SELECT @@time_zone, @@system_time_zone;确认环境时区，别依赖本地开发机设置
实际业务中，最常被忽略的是时区隐式转换和 MONTH 单位的语义——它算的是日历位置差，不是30天倍数。这两个点一旦出错，数据报表就容易偏移，而且很难一眼发现。
