timestampdiff是最稳妥的时间差计算函数,按指定单位返回整型差值且向下取整;需注意单位大写、参数顺序为单位/起始/结束,跨天时长用它,null需预处理,时区和字符串格式也需规范。

用 TIMESTAMPDIFF 直接获取天数、小时、秒等整型差值
这是最常用也最稳妥的方式,TIMESTAMPDIFF 能按指定单位返回两个日期之间的完整间隔(向下取整),不依赖时区隐式转换,也不怕跨月/跨年问题。
常见错误是把单位参数写错顺序或拼错:DAY、HOUR、MINUTE、SECOND 必须大写,且第一个参数是单位,第二个是起始时间,第三个是结束时间 —— 顺序反了结果就是负数。
-
TIMESTAMPDIFF(DAY, '2024-01-01', '2024-01-05')→ 返回4 -
TIMESTAMPDIFF(HOUR, '2024-01-01 10:00:00', '2024-01-02 12:30:00')→ 返回26(不是 26.5,小数部分直接截断) - 如果起始时间晚于结束时间,结果为负数,需自行
ABS()处理
用 DATEDIFF 只算日期差(忽略时分秒)
DATEDIFF 实际上是 TIMESTAMPDIFF(DAY, ...) 的简化版,但它会自动把两个时间截断到日期部分再计算 —— 也就是说 '2024-01-01 23:59:59' 和 '2024-01-02 00:00:01' 的差仍是 1,但如果你需要精确到小时,它就不适用了。
-
DATEDIFF('2024-01-01 15:00:00', '2024-01-01 09:00:00')→ 返回0(同一天,不管几点) -
DATEDIFF('2024-01-02', '2024-01-01 23:59:59')→ 返回1(日期变了就算一天) - 它只接受
DATE或DATETIME类型,传入字符串时 MySQL 会尝试隐式转换,但遇到格式异常(如'01/01/2024')可能返回NULL
用 TIMEDIFF 算两个时间点之间的时长(仅限同一天内)
TIMEDIFF 返回的是 TIME 类型的结果,比如 '48:30:15',但它不处理日期部分 —— 如果你传入跨天的时间,比如 TIMEDIFF('2024-01-02 01:00:00', '2024-01-01 23:00:00'),MySQL 会把它当成两个 TIME 值相减,结果是 '02:00:00'(而非 26 小时),容易误判。
- 适合场景:计算当天内两个操作的耗时,如登录时间与登出时间
- 返回值不能直接用于数值计算(比如
SUM()),得先用TIME_TO_SEC()转成秒再处理 - 若需跨天时长,必须改用
TIMESTAMPDIFF(SECOND, ...)再自己换算
注意时区和字段类型对结果的影响
如果表里存的是 TIMESTAMP 字段,MySQL 默认按系统时区存储和读取;而 DATETIME 是“所见即所得”,不随服务器时区变化。两者混用时,TIMESTAMPDIFF 计算结果可能因会话时区不同而浮动。
- 执行
SELECT @@time_zone确认当前会话时区,必要时用CONVERT_TZ()统一转换后再算差值 -
NULL值参与任何时间差函数都会让整行结果变成NULL,建议提前用IFNULL()或COALESCE()处理 - 从字符串解析时间时,优先用
STR_TO_DATE()显式指定格式,避免依赖 MySQL 的模糊匹配(比如'2024-01-01'可能被识别,但'01-01-2024'就不一定)
TIMESTAMPDIFF 配合明确单位最不容易出错,但得盯紧参数顺序和 NULL 边界。











