如何在MySQL中精确计算两个日期的差值_使用TIMESTAMPDIFF函数-mysql教程-PHP中文网

timestampdiff 返回“完整间隔数”，非四舍五入值；如364天差返回0年，365天才返1；按日历边界计算，月末日期自动向下取整；索引失效需改写条件为字段 op 表达式；跨时区须显式转换至utc。

如何在mysql中精确计算两个日期的差值_使用timestampdiff函数

因为 TIMESTAMPDIFF 计算的是“完整间隔数”，不是四舍五入或截断后的近似值。比如两个日期相差 364 天，用 TIMESTAMPDIFF(YEAR, ...) 得到 0；相差 365 天才得 1。它不看小数部分，只看跨过了多少个完整的单位边界。

常见错误是误以为它类似 Excel 的 DATEDIF 或 Python 的 relativedelta —— 实际上它更接近“日历计数器”：只统计从起始时间到结束时间之间，目标单位（如年、月）的整数次变化次数。

单位必须用大写常量：YEAR、MONTH、DAY、HOUR、MINUTE、SECOND
参数顺序固定：TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)，结果 = datetime_expr2 - datetime_expr1
若 datetime_expr1 > datetime_expr2，结果为负数，不会报错

它按日历月计算：比较两个日期的年份差 ×12 + 月份差，再根据“是否已过当月对应日”微调。例如：

SELECT TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-28'); -- 返回 0（2月28日还没到1月31日的“下个月”）

而：

SELECT TIMESTAMPDIFF(MONTH, '2023-01-28', '2023-02-28'); -- 返回 1

本质是 MySQL 内部把两个日期归一化到“同日”比较，遇到月末日期会自动向下取整（如 1月31日 → 1月30日），再做减法。

会。只要字段被包裹在函数中，如 WHERE TIMESTAMPDIFF(DAY, created_at, NOW()) > 30，MySQL 无法直接使用 created_at 上的索引，必须全表扫描。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

正确做法是把函数移到右侧，让左侧保持裸字段：

WHERE created_at <p>这样优化器能走索引。同理适用于 <code>DATE_ADD</code>、<code>DATE_SUB</code> 等日期运算函数。</p>

它默认按会话时区解释输入值。如果你传入的字符串没带时区信息（如 '2023-05-01'），MySQL 会当作当前会话时区的时间处理；若字段是 TIMESTAMP 类型，则存储时已转为 UTC，读取时再转回会话时区——这会导致两次转换叠加，差值失真。

最稳的方式是统一转成 UTC 时间戳再算：

SELECT TIMESTAMPDIFF(HOUR,
  CONVERT_TZ('2023-05-01 10:00:00', '+08:00', '+00:00'),
  CONVERT_TZ('2023-05-01 15:00:00', '-05:00', '+00:00')
);

真正麻烦的不是函数怎么写，而是你是否清楚自己要的是“日历差”还是“物理时长差”。选错单位或忽略时区/月末规则，查出来的数字看起来对，其实已经偏了几天甚至几个月。

如何在MySQL中精确计算两个日期的差值_使用TIMESTAMPDIFF函数