MySQL计算日期差值，最直接的方式是使用内置函数
DATEDIFF()来获取两个日期之间的天数，或者通过
TIMESTAMPDIFF()函数来获取任意指定时间单位（如年、月、日、小时、分钟、秒）的精确差值。具体选择哪个，往往取决于你对“差值”的业务定义和精度要求。
解决方案
在MySQL里，处理日期差值，我们通常会用到两个核心函数：
DATEDIFF()和
TIMESTAMPDIFF()。
DATEDIFF(expr1, expr2)是最直观的一个，它直接返回
expr1 - expr2的天数。这里需要注意，它只关心日期部分，时间部分会被忽略。比如说，
DATEDIFF('2023-10-26 23:59:59', '2023-10-25 00:00:01') 结果会是 1，因为它只比较了
2023-10-26和
2023-10-25。
SELECT DATEDIFF('2023-10-26', '2023-10-25'); -- 结果: 1
SELECT DATEDIFF('2023-10-26 23:59:59', '2023-10-25 00:00:01'); -- 结果: 1 (时间部分被忽略)
SELECT DATEDIFF('2023-10-25', '2023-10-26'); -- 结果: -1而
TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)则提供了更细粒度的控制。它能计算两个日期或日期时间表达式之间，在指定时间单位下的差值。
unit参数可以是
MICROSECOND,
SECOND,
MINUTE,
HOUR,
DAY,
WEEK,
MONTH,
QUARTER,
YEAR等。它的计算方式是
datetime_expr2 - datetime_expr1，这点和
DATEDIFF的参数顺序是反的，初次使用时很容易搞混。
-- 计算天数差值 SELECT TIMESTAMPDIFF(DAY, '2223-10-25 00:00:01', '2223-10-26 23:59:59'); -- 结果: 1 -- 计算小时差值 SELECT TIMESTAMPDIFF(HOUR, '2023-10-25 00:00:01', '2023-10-26 23:59:59'); -- 结果: 47 -- 计算月数差值 SELECT TIMESTAMPDIFF(MONTH, '2023-01-15', '2023-03-01'); -- 结果: 2
通常，我个人更倾向于使用
TIMESTAMPDIFF()，因为它更通用，能满足大部分场景对不同时间单位差值的需求。
DATEDIFF()嘛，就留给那些确实只需要纯粹“天数”差值的场景。
为什么DATEDIFF有时候感觉“不太对劲”？
这确实是个常见的问题，我刚开始用的时候也觉得有点别扭，总觉得差了那么一点点。
DATEDIFF的“不太对劲”之处，主要在于它对时间部分的完全忽略。它只关注日期的年、月、日，只要日期不同，哪怕只差一秒，它也算作一天。
举个例子，如果你的业务场景是计算用户登录的间隔天数，而用户在
2023-10-25 23:59:00登录，又在
2023-10-26 00:01:00再次登录。
DATEDIFF('2023-10-26 00:01:00', '2023-10-25 23:59:00') 会返回 1。从日期层面看，确实是跨了一天。但如果你的“天数”定义是“完整经过的24小时周期”，那这个结果显然就不准确了，因为实际只过去了2分钟。
在这种需要考虑时间精度的情况下，
DATEDIFF就不太适用了。这时，
TIMESTAMPDIFF就能派上用场。比如，如果你想知道实际过去了多少个完整的24小时，可以这样：
SELECT FLOOR(TIMESTAMPDIFF(SECOND, '2023-10-25 23:59:00', '2023-10-26 00:01:00') / (24 * 3600)); -- 结果: 0 (因为实际不足24小时)
这个例子就清晰地展示了
DATEDIFF的局限性，以及如何通过
TIMESTAMPDIFF和一些简单的数学运算来弥补。所以，关键在于你对“差值”的业务定义，一旦定义明确，选择合适的函数就容易多了。
除了天数，我还能计算哪些时间单位的差值？
这是
TIMESTAMPDIFF真正展现其强大之处的地方。它支持的时间单位非常丰富，几乎涵盖了我们日常开发中所有可能需要的时间维度。
你可以计算：
微秒 (MICROSECOND)：这精度已经很高了，适用于对时间要求极其精确的场景。 秒 (SECOND)：计算两个时间点之间总共相差多少秒。 分钟 (MINUTE)：计算分钟差。 小时 (HOUR)：计算小时差。 天 (DAY)：和DATEDIFF类似，但
TIMESTAMPDIFF的参数顺序是反的。 周 (WEEK)：计算周数差，以7天为一周。 月 (MONTH)：计算月数差，这个单位的计算方式比较特殊，它主要看月份的边界。 季度 (QUARTER)：计算季度差，每三个月为一个季度。 年 (YEAR)：计算年份差。
举几个例子：
-- 计算两个日期时间相差多少秒 SELECT TIMESTAMPDIFF(SECOND, '2023-10-25 10:00:00', '2023-10-25 10:01:30'); -- 结果: 90 -- 计算两个日期时间相差多少小时 SELECT TIMESTAMPDIFF(HOUR, '2023-10-25 10:00:00', '2023-10-26 12:00:00'); -- 结果: 26 -- 计算两个日期相差多少个月 -- 注意：TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-01') 结果是 1，因为它跨越了月份边界 SELECT TIMESTAMPDIFF(MONTH, '2023-01-15', '2023-03-10'); -- 结果: 2 SELECT TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-01'); -- 结果: 1 -- 计算两个日期相差多少年 SELECT TIMESTAMPDIFF(YEAR, '2022-12-31', '2023-01-01'); -- 结果: 1 (跨年即算1年)
这才是真正让我觉得MySQL在日期处理上灵活的地方。只要你明确了需要哪个时间单位的差值，
TIMESTAMPDIFF几乎都能直接给出答案。不过，对于
MONTH和
YEAR这两个单位，它只是简单地计算跨越了多少个边界，而不是实际经过了多少个“完整”的月或年。这个细节在处理某些业务逻辑时，比如计算会员的“完整”订阅周期，就需要额外注意了。
如何处理跨年、跨月的复杂日期差值计算？
处理跨年、跨月的复杂日期差值，尤其是当“差值”的定义不仅仅是简单地跨越边界时，确实需要我们更深入地思考。
TIMESTAMPDIFF(MONTH, ...)和
TIMESTAMPDIFF(YEAR, ...)默认的行为是基于月份或年份的边界进行计数，这在很多情况下是符合预期的，但有时也会带来“惊喜”。
例如，我们想计算两个日期之间“完整”经过了多少个月。如果只是用
TIMESTAMPDIFF(MONTH, '2023-01-31', '2023-02-01')，结果是
1。但从实际经过的时间来看，这显然不足一个完整的月。
要获取“完整”的月数或年数，我们可能需要一些变通方法。一种常见的思路是，先计算总天数，然后根据平均天数进行近似转换，但这通常只适用于粗略估算。
如果需要更精确的“完整月数”或“完整年数”，一种方法是结合日期格式化和条件判断：
计算两个日期之间“完整”的月数：
SELECT
PERIOD_DIFF(DATE_FORMAT('2023-03-10', '%Y%m'), DATE_FORMAT('2023-01-15', '%Y%m')) AS month_diff_by_period;
-- 结果: 2 (PERIOD_DIFF 计算的是 'YYYYMM' 格式的差值，适用于计算完整的月)
-- 结合条件判断，确保只有当日期部分也满足“完整”时才计数
SELECT
TIMESTAMPDIFF(MONTH, '2023-01-15', '2023-03-10') -
(CASE WHEN DAY('2023-03-10') < DAY('2023-01-15') THEN 1 ELSE 0 END) AS full_months_passed;
-- 结果: 2 (因为10号不小于15号，所以不减1)
SELECT
TIMESTAMPDIFF(MONTH, '2023-01-15', '2023-03-01') -
(CASE WHEN DAY('2023-03-01') < DAY('2023-01-15') THEN 1 ELSE 0 END) AS full_months_passed;
-- 结果: 1 (TIMESTAMPDIFF(MONTH)是2，但01号小于15号，所以减1，得到1个完整月)对于“完整年数”的计算，逻辑也类似：
SELECT
TIMESTAMPDIFF(YEAR, '2022-03-15', '2023-02-10') -
(CASE WHEN MONTH('2023-02-10') < MONTH('2022-03-15') OR (MONTH('2023-02-10') = MONTH('2022-03-15') AND DAY('2023-02-10') < DAY('2022-03-15')) THEN 1 ELSE 0 END) AS full_years_passed;
-- 结果: 0 (TIMESTAMPDIFF(YEAR)是1，但2月10日早于3月15日，所以减1，得到0个完整年)这块儿就比较考验我们对业务需求的理解了，数据库函数是工具，但怎么用好，还得看我们怎么定义“差值”。有时候，如果需求特别复杂，比如需要考虑闰年、节假日、工作日等因素，那可能就不是单靠几个SQL函数能直接解决的了，可能需要在应用程序层面编写更复杂的逻辑来处理。但对于绝大多数常规的日期差值计算，MySQL提供的
DATEDIFF和
TIMESTAMPDIFF已经足够强大和灵活了。
