快捷導(dǎo)航

MySQL中的timediff、timestampdiff、datediff函數(shù)詳細(xì)對(duì)比和說(shuō)明

更新時(shí)間：2026年01月15日 09:57:13 作者：AI老李

這篇文章主要介紹了MySQL中timediff、timestampdiff、datediff函數(shù)詳細(xì)對(duì)比和說(shuō)明的相關(guān)資料,通過(guò)示例代碼詳細(xì)對(duì)比了它們的用途、參數(shù)和返回值,并提供了示例和易記口訣幫助記憶,需要的朋友可以參考下

前言

這三個(gè)函數(shù)都是 MySQL 中常用的日期時(shí)間差值計(jì)算函數(shù)，但用途、參數(shù)和返回值完全不同。以下是詳細(xì)對(duì)比和說(shuō)明。

函數(shù)名稱	返回值類(lèi)型	功能描述	支持的時(shí)間單位	典型用途
DATEDIFF	INT（天數(shù)）	計(jì)算兩個(gè)日期相差的天數(shù)（僅精確到天）	天（忽略時(shí)間部分）	計(jì)算兩個(gè)日期之間相隔多少天
TIMEDIFF	TIME 類(lèi)型	計(jì)算兩個(gè)時(shí)間/日期時(shí)間的差值，返回時(shí):分:秒格式	時(shí)、分、秒、微秒	計(jì)算同一日內(nèi)或跨天的小時(shí)級(jí)時(shí)間差
TIMESTAMPDIFF	INT（指定單位）	計(jì)算兩個(gè)日期時(shí)間相差的完整單位數(shù)量（最靈活）	YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, MICROSECOND 等	精確計(jì)算任意單位的間隔數(shù)量

1. DATEDIFF(expr1, expr2)

語(yǔ)法：DATEDIFF(expr1, expr2)
返回值：expr1 − expr2 的天數(shù)（整數(shù)）。時(shí)間部分被忽略。
計(jì)算規(guī)則：expr1 - expr2，正數(shù)表示 expr1 在 expr2 之后。

示例：

SELECT DATEDIFF('2025-12-30', '2025-12-01');     -- 29
SELECT DATEDIFF('2025-12-01', '2025-12-30');     -- -29
SELECT DATEDIFF('2025-12-30 10:00:00', '2025-12-01 23:59:59'); -- 29（時(shí)間部分忽略）

適用場(chǎng)景：統(tǒng)計(jì)年齡（年份差需結(jié)合其他計(jì)算）、會(huì)員注冊(cè)天數(shù)、訂單間隔天數(shù)等。

2. TIMEDIFF(expr1, expr2)

語(yǔ)法：TIMEDIFF(expr1, expr2)
返回值：TIME 類(lèi)型，格式為 ‘HHH:MM:SS’（可超過(guò)24小時(shí)，如 48:00:00，支持負(fù)值）。
限制：
- 兩個(gè)參數(shù)都必須是 TIME 或 DATETIME 類(lèi)型。
- 結(jié)果范圍：-838:59:59 到 838:59:59（約34天多）。
- 如果差值超出范圍，返回 NULL。

示例：

SELECT TIMEDIFF('2025-12-30 15:30:00', '2025-12-30 10:20:30'); -- '05:09:30'
SELECT TIMEDIFF('10:20:30', '15:30:00');                       -- '-05:09:30'
SELECT TIMEDIFF('2025-12-31 12:00:00', '2025-12-30 10:00:00'); -- '26:00:00'

適用場(chǎng)景：計(jì)算工作時(shí)長(zhǎng)、打卡上下班時(shí)間差、會(huì)議持續(xù)時(shí)間等需要精確到秒的時(shí)間段。

3. TIMESTAMPDIFF(unit, expr1, expr2)

語(yǔ)法：TIMESTAMPDIFF(unit, datetime_expr1, datetime_expr2)
返回值：expr2 − expr1 的指定單位數(shù)量（整數(shù)）。
注意順序：是 expr2 - expr1（與前兩個(gè)函數(shù)順序相反?。?/li>
常用 unit 參數(shù)（不區(qū)分大小寫(xiě)）：
- MICROSECOND, SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR

示例：

SELECT TIMESTAMPDIFF(DAY, '2025-12-01', '2025-12-30');     -- 29
SELECT TIMESTAMPDIFF(MONTH, '2025-10-15', '2025-12-20');   -- 2
SELECT TIMESTAMPDIFF(HOUR, '2025-12-30 10:00:00', '2025-12-31 15:30:00'); -- 29
SELECT TIMESTAMPDIFF(YEAR, '2020-01-01', '2025-12-30');    -- 5
SELECT TIMESTAMPDIFF(MINUTE, '10:00:00', '15:30:45');      -- 330

適用場(chǎng)景：最常用！可以精確計(jì)算任意單位的時(shí)間差，如用戶年齡（YEAR）、會(huì)員時(shí)長(zhǎng)（MONTH）、響應(yīng)時(shí)間（SECOND）等。

三者對(duì)比總結(jié)（記憶口訣）

需求	推薦函數(shù)	原因
只想知道相差多少天	DATEDIFF	最簡(jiǎn)單，直接返回天數(shù)
需要返回時(shí):分:秒格式的時(shí)間差	TIMEDIFF	返回 TIME 類(lèi)型，適合展示時(shí)長(zhǎng)
需要精確到任意單位（年/月/日/時(shí)/分/秒）	TIMESTAMPDIFF（首選）	最靈活，單位可自定義，推薦大多數(shù)場(chǎng)景使用

常見(jiàn)誤區(qū)

參數(shù)順序不一致：
- DATEDIFF 和 TIMEDIFF 是 expr1 - expr2
- TIMESTAMPDIFF 是 expr2 - expr1（后減前）
DATEDIFF 忽略時(shí)間部分，而 TIMESTAMPDIFF(DAY, …) 會(huì)考慮完整時(shí)間。

計(jì)算年齡時(shí)不要直接用 DATEDIFF/365（閏年問(wèn)題），推薦：

TIMESTAMPDIFF(YEAR, birth_date, CURDATE()) - 
(DATE_FORMAT(CURDATE(), '%m%d') < DATE_FORMAT(birth_date, '%m%d'))

掌握了這三個(gè)函數(shù)，你就能輕松處理 MySQL 中絕大部分日期時(shí)間差計(jì)算需求！

總結(jié)

到此這篇關(guān)于MySQL中timediff、timestampdiff、datediff函數(shù)詳細(xì)對(duì)比和說(shuō)明的文章就介紹到這了,更多相關(guān)MySQL timediff、timestampdiff、datediff函數(shù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: