TIMESTAMPDIFF计算分钟差必须显式指定单位MINUTE，拼写严格匹配且不区分大小写；其按日历逻辑而非线性秒差计算，跨数据库不可移植，大表查询需避免全表扫描。
MySQL里用TIMESTAMPDIFF算分钟差，单位必须写MINUTE
直接传两个时间值进去，TIMESTAMPDIFF不会自动猜单位——漏写或错写单位参数（比如写成'minute'小写、minutes复数、甚至min），结果全为NULL或0。MySQL对单位参数大小写不敏感，但拼写必须严格匹配MINUTE（官方文档指定的关键词）。
常见错误场景：从其他数据库迁移SQL时习惯性写MINUTES，或在ORM里拼接SQL时变量注入了错误字符串。
-
TIMESTAMPDIFF(MINUTE, '2024-01-01 10:00:00', '2024-01-01 10:35:20')→ 返回35 -
TIMESTAMPDIFF(MINUTE, start_time, end_time)中两个字段类型应为DATETIME、TIMESTAMP或能隐式转为时间的字符串（如'2024-01-01 12:30'） - 如果字段是
INT存的Unix时间戳，得先用FROM_UNIXTIME()转换，否则计算结果无意义
注意时区和日期边界：跨天/跨月时TIMESTAMPDIFF按日历单位“整段”计算
TIMESTAMPDIFF不是简单做秒数相减再除60，而是按日历逻辑推算——比如TIMESTAMPDIFF(MINUTE, '2024-02-28 23:59:00', '2024-03-01 00:01:00')返回1442（24×60 + 2），而不是1440 + 2 = 1442这个结果看似一样，但本质不同；而TIMESTAMPDIFF(MINUTE, '2024-01-31 23:59:00', '2024-02-01 00:01:00')也返回1442，因为它是按“1天零2分钟”算的，不是纯线性秒差。
这意味着：如果你要的是精确到秒的线性分钟数（即(end - start) / 60），别用TIMESTAMPDIFF，改用TIMESTAMPDIFF(SECOND, ...)再除60并ROUND，或者直接用TIMESTAMPDIFF配合SECOND单位更稳妥。
- 要线性分钟（含小数）：用
ROUND(TIMESTAMPDIFF(SECOND, t1, t2) / 60.0, 1) - 要整数日历分钟（忽略秒级差异）：直接
TIMESTAMPDIFF(MINUTE, t1, t2) - 字段含时区信息（如
TIMESTAMP类型受session time_zone影响），确保连接时区一致，否则同一数据在不同时区会算出不同结果
PostgreSQL或SQLite用户别硬套TIMESTAMPDIFF——它不是SQL标准函数
TIMESTAMPDIFF是MySQL专属函数，PostgreSQL用EXTRACT(EPOCH FROM (t2 - t1)) / 60，SQLite用(julianday(t2) - julianday(t1)) * 24 * 60。直接把MySQL SQL扔进其他引擎会报错function timestampdiff does not exist或语法错误。
如果你在写跨数据库兼容代码，要么抽象出方言适配层，要么统一用基础运算（如秒差再除60），避免绑定特定函数。
- PostgreSQL示例：
EXTRACT(EPOCH FROM (TIMESTAMP '2024-01-01 14:30' - TIMESTAMP '2024-01-01 14:05')) / 60→25.0 - SQLite示例：
ROUND((julianday('2024-01-01 14:30') - julianday('2024-01-01 14:05')) * 1440)→25（SQLite中julianday差值是天，乘1440得分钟） - 别在WHERE条件里对大表字段反复调用
TIMESTAMPDIFF，MySQL无法有效利用索引，应考虑预计算字段或改用范围查询（如t2 > DATE_ADD(t1, INTERVAL 30 MINUTE)）
遇到NULL结果？优先检查输入值是否为NULL或非法格式
TIMESTAMPDIFF只要任一参数为NULL，结果必为NULL；如果传入非法时间字符串（如'2024-13-01'、'abc'），MySQL在严格模式下会报错，在宽松模式下可能转成'0000-00-00 00:00:00'，导致差值巨大且难以排查。
- 加
IS NOT NULL判断：WHERE start_time IS NOT NULL AND end_time IS NOT NULL - 用
STR_TO_DATE()做安全转换：TIMESTAMPDIFF(MINUTE, STR_TO_DATE(raw_str1, '%Y-%m-%d %H:%i:%s'), STR_TO_DATE(raw_str2, '%Y-%m-%d %H:%i:%s')) - 开发阶段可在SELECT里加
CASE WHEN ... THEN ... ELSE 'invalid' END辅助定位脏数据
实际用的时候，最常掉坑的地方不是函数怎么写，而是没意识到它算的是日历单位而非线性差值，以及跨数据库时想当然复用。留个心眼，查查执行计划里有没有全表扫描，再确认下字段是不是真时间类型——比死磕函数语法有用得多。
