MySQL 日期時間函數大全：從基礎提取到複雜運算的完整參考

MySQL 日期時間函數完整手冊（上）

系統整理 MySQL 核心日期時間函數，涵蓋提取、運算、格式化、區間計算四大類，附帶實測示例與版本差異說明。

一、日期提取函數

二、周計算函數：WEEK() 與 YEARWEEK()

WEEK(date[, mode])
YEARWEEK(date[, mode])

mode 參數詳解：

關鍵行為差異

• WEEK('2000-01-01', 0) → 0（屬於上一年最後一周）
• WEEK('2000-01-01', 2) → 52（ISO 模式歸屬上年）
• YEARWEEK('2000-01-01') → 199952（年周組合，避免歧義）

建議：跨年周計算統一使用 mode=3 (ISO 8601) 或 YEARWEEK()，避免業務邏輯錯誤。

三、時間提取函數

四、期間運算：PERIOD_ADD / PERIOD_DIFF

• 參數格式：YYMM 或 YYYYMM（非日期類型）
• PERIOD_ADD(9801, 2) → 199803（加 2 月）
• PERIOD_DIFF(9802, 199703) → 11（月數差）

五、日期算術：DATE_ADD / DATE_SUB / ADDDATE / SUBDATE

DATE_ADD(date, INTERVAL expr type)
DATE_SUB(date, INTERVAL expr type)

type 與 expr 格式對應表：

實測示例

"1997-12-31 23:59:59" + INTERVAL 1 SECOND     → 1998-01-01 00:00:00
INTERVAL 1 DAY + "1997-12-31"                   → 1998-01-01
"1998-01-01" - INTERVAL 1 SECOND                → 1997-12-31 23:59:59
DATE_ADD("1997-12-31 23:59:59", INTERVAL 1 DAY) → 1998-01-01 23:59:59
DATE_ADD("1997-12-31 23:59:59", INTERVAL "1:1" MINUTE_SECOND) → 1998-01-01 00:01:00
DATE_SUB("1998-01-01 00:00:00", INTERVAL "1 1:1:1" DAY_SECOND) → 1997-12-30 22:58:59
DATE_ADD("1998-01-01 00:00:00", INTERVAL "-1 10" DAY_HOUR) → 1997-12-30 14:00:00
DATE_SUB("1998-01-02", INTERVAL 31 DAY)         → 1997-12-02

返回類型規則

• 若 date 為 DATE 且間隔僅含 YEAR/MONTH/DAY → 返回 DATE
• 否則返回 DATETIME
• MySQL 3.23+ 支持 +/- 運算符簡寫（右操作數為日期/間隔）

六、實用查詢模式：近 30 天數據

SELECT * FROM tbl_name
WHERE TO_DAYS(NOW()) - TO_DAYS(date_col) <= 30;