MySQL DATE_FORMAT 函數內建格式化符號完整參考表

DATE_FORMAT(date, format) 語法

根據 format 字串將日期/時間值格式化為字串。date 可為 DATE、DATETIME、TIMESTAMP、字串或數字。

完整格式化符號表

常用組合範例

進階用法

搭配 STR_TO_DATE 反向解析

SELECT STR_TO_DATE('2024-01-15 14:30:45', '%Y-%m-%d %H:%i:%s');
-- 返回 DATETIME 值

在 WHERE 條件中使用（注意索引失效）

-- 低效：全表掃描
SELECT * FROM orders WHERE DATE_FORMAT(created_at, '%Y-%m') = '2024-01';

-- 高效：範圍查詢走索引
SELECT * FROM orders 
WHERE created_at >= '2024-01-01' AND created_at < '2024-02-01';

時區考量

• DATE_FORMAT 使用會話時區 (time_zone 系統變數)
• 儲存建議用 TIMESTAMP (自動 UTC 轉換) 或應用層統一 UTC 存 DATETIME

總結

DATE_FORMAT 符號豐富，掌握 %Y-%m-%d %H:%i:%s 等常用組合即可覆蓋 95% 場景。切記：WHERE 條件勿用 DATE_FORMAT 包裹欄位，改用範圍查詢利用索引。