在MySQL数据库里处理时间数据是常见的开发任务，比如给用户的下单时间加上三十分钟作为支付截止时间，或者给任务创建时间追加几小时作为提醒时间。ADDTIME函数就是专门用来把指定的时间间隔加到时间或日期时间值上的内置函数，它可以操作TIME、DATETIME以及DATE类型的数据，并返回计算后的结果。
ADDTIME函数的语法与参数解析
ADDTIME函数的基本语法是 ADDTIME(expr1, expr2)，其中第一个参数 expr1 是原始的时间或日期时间值，第二个参数 expr2 是要追加的时间间隔。时间间隔可以是TIME类型的字符串如 '02:30:00'，也可以是带有天数的表达式如 '1 02:00:00'，甚至可以是一个数字但会被当作秒数处理。函数返回的结果类型取决于第一个参数的类型：如果 expr1 是TIME，返回TIME；如果是DATETIME或DATE，返回DATETIME。
需要注意的是，当第一个参数是DATE类型时，MySQL会先把它转换为DATETIME（时间部分为00:00:00），然后再加上间隔。例如 ADDTIME('2023-05-01', '12:00:00') 得到 '2023-05-01 12:00:00'。如果第二个参数包含了天数部分，那么日期也会相应增加。下面的代码展示了几种典型的调用方式及其返回结果：
SELECT ADDTIME('10:20:30', '02:10:10') AS t1;
-- 返回 12:30:40，纯时间相加
SELECT ADDTIME('2023-05-01 08:00:00', '1 02:00:00') AS t2;
-- 返回 2023-05-02 10:00:00，跨天增加
SELECT ADDTIME('2023-05-01', '36:00:00') AS t3;
-- 返回 2023-05-02 12:00:00，日期自动顺延
SELECT ADDTIME(NOW(), '00:30:00') AS t4;
-- 给当前时间加30分钟
从底层实现来看，ADDTIME会把第二个参数统一换算成微秒或秒级别精度再与第一个参数累加，因此它对小数秒也是支持的。如果原始时间带有小数位如 '10:20:30.123456'，追加 '00:00:01.000000' 会得到 '10:20:31.123456'。这种精度保持特性在性能监控类应用中非常实用，可以避免时间计算导致精度丢失。
实际业务中的常见用法示例
在真实项目中，ADDTIME最典型的用法是计算业务的到期时间。例如电商系统中，用户下单后需要在两小时内支付，我们可以用下单时间加上两小时得到最晚支付时间，并在查询未支付订单时与该时间比较。这种写法比使用DATE_ADD更直观，也不需要记忆INTERVAL关键字的各种单位拼写。
另一个常见场景是批处理任务的时间窗口划分。假设我们按每小时一个批次处理日志，可以用ADDTIME给上一个批次的起始时间加上一小时得到下一批次起始时间。配合WHERE条件就能轻松捞出某个时间窗口内的数据。以下示例演示了如何筛选出下单后超过三十分钟仍未支付的订单：
-- 订单表 order_info 含有 create_time 字段和 status 字段 SELECT order_id, create_time, ADDTIME(create_time, '00:30:00') AS pay_deadline FROM order_info WHERE status = 'unpaid' AND NOW() > ADDTIME(create_time, '00:30:00');
除了直接写死间隔字符串，ADDTIME也可以接收列作为第二个参数。比如有一张配置表保存了不同用户等级的超时分钟数（以TIME格式存于列中），就能直接关联计算。这种灵活性让它能适应多变的业务规则，而不必每次都改SQL结构。不过要注意，如果间隔列里出现了NULL，整个函数结果也会变成NULL，所以使用前最好用IFNULL兜底。
使用ADDTIME时的易错点与注意事项
开发者最容易踩的坑是第二个参数格式不对导致返回NULL。比如写成 ADDTIME(time_col, 90) 本意是加90秒，但某些MySQL版本或SQL模式下会把数字90当成TIME的隐式转换失败而返回NULL；稳妥的做法是写成 '00:01:30' 或使用 SEC_TO_TIME(90)。另外，当第一个参数是纯粹DATE且第二个参数间隔很大时，很多人误以为只返回日期，其实日期已被推进，这点要在应用层格式化时留意。
还有一个性能层面的隐患：在WHERE子句里对索引列使用ADDTIME会导致索引失效，因为函数作用在列上后优化器无法直接使用B树索引。如果数据量大，应改为对比较值做运算，例如 WHERE create_time < ADDTIME(NOW(), '-00:30:00') 这种反向写法，或者利用生成列加索引。下面的示例展示了如何用反向计算保持索引可用：
-- 避免对 create_time 使用函数，改为计算边界值 SELECT order_id FROM order_info WHERE create_time < ADDTIME(NOW(), '-02:00:00'); -- 意思是找出两小时前创建的记录，索引可有效命中
最后要区分ADDTIME和TIMEDIFF、DATE_ADD的职责。TIMEDIFF求两个时间差，DATE_ADD功能更全但语法啰嗦，ADDTIME胜在轻量直观。在只需要简单加小时分钟秒的场景，优先选ADDTIME能减少代码噪音。只要留意参数格式和索引影响，它就能成为时间计算里顺手的好工具。