MySQL TIMESTAMPDIFF 函数详解：精准计算日期时间差值 | 极客日志

SQL

MySQL TIMESTAMPDIFF 函数详解：精准计算日期时间差值

MySQL TIMESTAMPDIFF 函数用于计算两个日期或时间戳之间的差值，支持多种时间单位如年、月、日等。该函数允许混合类型参数，自动处理 DATE 和 DATETIME 转换。通过指定 UNIT 参数可获取不同精度的差值结果，常用于年龄计算或时间间隔统计。注意函数仅截取与单位相关的时间部分，秒级精度需配合 SECOND 单位使用。

BigDataPan发布于 2025/1/17更新于 2026/4/262 浏览

MySQL TIMESTAMPDIFF 函数详解：精准计算日期时间差值

MySQL TIMESTAMPDIFF 函数详解

在处理业务逻辑时，我们经常需要计算两个时间点之间的间隔。MySQL 提供了 TIMESTAMPDIFF 函数来高效完成这一任务。它的语法结构非常直观：

TIMESTAMPDIFF(unit, begin, end);

这个函数返回两个时间点的差值。begin 和 end 可以是表达式，且允许混合类型。例如，如果 begin 是 DATE 而 end 是 DATETIME，函数会自动将 DATE 视为时间部分为 00:00:00 的 DATETIME 值。

支持的单位

unit 参数决定了返回值的计量单位，可选值包括：

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

基础用法示例

假设我们要计算 2018 年 1 月 1 日到 2018 年 6 月 1 日的月份差：

SELECT TIMESTAMPDIFF(MONTH, '2018-01-01', '2018-06-01') AS result;

执行结果为 5。如果换成按天计算，只需修改单位：

SELECT TIMESTAMPDIFF(DAY, '2010-01-01', '2010-06-01') AS result;

这里会返回 151 天。

对于更精确的时间点，比如分钟级的差异，我们可以这样写：

SELECT TIMESTAMPDIFF(MINUTE, '2018-01-01 10:00:00', '2018-01-01 10:45:00') AS result;

结果是 45。这里有个细节需要注意：TIMESTAMPDIFF 只考虑与 unit 参数匹配的时间部分。如果你传入的是 MINUTE，即使结束时间多了 59 秒，它也不会进位。

SELECT TIMESTAMPDIFF(, , )  ;

SELECT TIMESTAMPDIFF(SECOND, '2018-01-01 10:00:00', '2018-01-01 10:45:59') AS result;

USE testdb;
CREATE TABLE persons (
    id INT AUTO_INCREMENT PRIMARY KEY,
    full_name VARCHAR(255) NOT NULL,
    date_of_birth DATE NOT NULL
);

INSERT INTO persons(full_name, date_of_birth) VALUES
('John Doe', '1990-01-01'),
('David Taylor', '1989-06-06'),
('Peter Drucker', '1985-03-02'),
('Lily Minsu', '1992-05-05'),
('Mary William', '1995-12-01');

SELECT id, full_name, date_of_birth, 
       TIMESTAMPDIFF(YEAR, date_of_birth, '2018-01-01') AS age 
FROM persons;

SELECT id, full_name, date_of_birth, 
       TIMESTAMPDIFF(YEAR, date_of_birth, NOW()) AS age 
FROM persons;