在MySQL数据库中，处理日期和时间数据是一项常见且重要的任务。
特别是当我们需要计算两个日期或时间之间的差异时，TIMESTAMPDIFF函数就显得尤为重要。

1. TIMESTAMPDIFF函数

TIMESTAMPDIFF函数用于计算两个日期或时间值之间的差异，并以指定的单位返回结果。

TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)

• unit 是指定差异单位的参数，可以是SECOND、MINUTE、HOUR、DAY、MONTH、YEAR等。
• datetime_expr1 和 datetime_expr2 是需要比较的两个日期或时间表达式。

参数

TIMESTAMPDIFF函数支持多种单位，以下是一些常用的单位：

• MICROSECOND：微秒
• SECOND：秒
• MINUTE：分钟
• HOUR：小时
• DAY：天
• WEEK：周
• MONTH：月
• QUARTER：季度
• YEAR：年

代码

-- 计算两个日期之间的微秒差异
SELECT TIMESTAMPDIFF(MICROSECOND, '2024-01-01 00:00:00', '2024-01-01 00:00:01') AS microsecond_diff;
-- 计算两个日期之间的秒差异
SELECT TIMESTAMPDIFF(SECOND, '2024-01-01 00:00:00', '2024-01-01 00:01:00') AS second_diff;
-- 计算两个日期之间的分钟差异
SELECT TIMESTAMPDIFF(MINUTE, '2024-01-01 00:00:00', '2024-01-01 00:10:00') AS minute_diff;
-- 计算两个日期之间的小时差异
SELECT TIMESTAMPDIFF(HOUR, '2024-01-01 00:00:00', '2024-01-01 01:00:00') AS hour_diff;
-- 计算两个日期之间的天差异
SELECT TIMESTAMPDIFF(DAY, '2024-01-01 00:00:00', '2024-01-02 00:00:00') AS day_diff;
-- 计算两个日期之间的周差异
SELECT TIMESTAMPDIFF(WEEK, '2024-01-01 00:00:00', '2024-01-08 00:00:00') AS week_diff;
-- 计算两个日期之间的月差异
SELECT TIMESTAMPDIFF(MONTH, '2024-01-01 00:00:00', '2024-02-01 00:00:00') AS month_diff;
-- 计算两个日期之间的季度差异
SELECT TIMESTAMPDIFF(QUARTER, '2024-01-01 00:00:00', '2024-04-01 00:00:00') AS quarter_diff;
-- 计算两个日期之间的年差异
SELECT TIMESTAMPDIFF(YEAR, '2024-01-01 00:00:00', '2025-01-01 00:00:00') AS year_diff;

2. 其他时间计算函数

在MySQL中，除了TIMESTAMPDIFF，还有其他几个函数也可以用来计算时间差，例如DATEDIFF和TIMEDIFF。

2.1 DATEDIFF

DATEDIFF函数用于计算两个日期之间的天数差异。

DATEDIFF(date1, date2)

• date1 和 date2 是两个日期值。
• 函数返回date1和date2之间的天数差，即date1 - date2。

SELECT DATEDIFF('2013-01-13', '2012-10-01') AS days_diff;

注意：DATEDIFF只计算天数差，不考虑时分秒部分。

2.2 TIMEDIFF

TIMEDIFF函数用于计算两个时间之间的差异。其语法如下：

TIMEDIFF(time1, time2)

• time1 和 time2 是两个时间值。
• 函数返回两个时间相减得到的差值，time1 - time2。

SELECT TIMEDIFF('2018-05-21 14:51:43', '2018-05-19 12:54:43') AS time_diff;

注意：TIMEDIFF只适用于时间（时分秒）差异的计算。

总结

函数名	单位支持	描述
TIMESTAMPDIFF	微秒、秒、分钟、小时、天、周、月、季度、年	计算两个日期时间之间的差异
DATEDIFF	天	计算两个日期之间的天数差异
TIMEDIFF	时间（时分秒）	计算两个时间之间的差异