| 函數 | 返回值範例 | 說明 |
|---|---|---|
NOW() | 2024-05-18 14:30:45 | 當前日期時間(DATETIME) |
CURDATE() | 2024-05-18 | 當前日期 |
CURTIME() | 14:30:45 | 當前時間 |
UNIX_TIMESTAMP() | 1716093045 | Unix 時間戳(秒) |
FROM_UNIXTIME(ts) | 2024-05-18 14:30:45 | 時間戳轉 DATETIME |
YEAR(date) -- 年份 (2024)
MONTH(date) -- 月份 (1-12)
MONTHNAME(date) -- 月份英文名 (May)
DAY(date) -- 月份中的天 (1-31)
DAYOFWEEK(date) -- 星期 (1=週日, 7=週六)
DAYOFYEAR(date) -- 年份中的天 (1-366)
WEEK(date, mode) -- 年份中的週數 (mode 決定週起始日)
QUARTER(date) -- 季度 (1-4)
HOUR(time) -- 小時 (0-23)
MINUTE(time) -- 分鐘 (0-59)
SECOND(time) -- 秒 (0-59)
日期字面值必須加引號,否則會被視為數字運算導致 NULL:
SELECT YEAR('2024-05-18'); -- 2024
SELECT YEAR(2024-05-18); -- NULL (計算 2024-5-18=2001)
-- 加 6 個月
DATE_ADD('2024-05-18', INTERVAL 6 MONTH) -- 2024-11-18
-- 減 6 小時
DATE_SUB('2024-05-18 10:00:00', INTERVAL 6 HOUR) -- 2024-05-18 04:00:00
-- 複合間隔:12 天 3 小時 45 分
DATE_ADD('2024-05-18', INTERVAL '12 03:45' DAY_MINUTE)
-- 年月間隔
DATE_SUB('2024-05-18', INTERVAL '13-4' YEAR_MONTH) -- 2011-01-18
支援單位:MICROSECOND, SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR 及複合單位(DAY_HOUR, YEAR_MONTH 等)。
TIME_TO_SEC('01:02:03') -- 3723
SEC_TO_TIME(3723) -- '01:02:03'
DATE_FORMAT(date, format)
常用格式符:
| 符號 | 意義 | 範例 |
|---|---|---|
| %Y | 四位數年份 | 2024 |
| %m | 兩位數月份 | 05 |
| %d | 兩位數日期 | 18 |
| %H | 24制小時 | 14 |
| %i | 分鐘 | 30 |
| %s | 秒數 | 45 |
| %W | 星期名稱 | Saturday |
| %M | 月份名稱 | May |
SELECT DATE_FORMAT(NOW(), '%Y-%m-%d %H:%i:%s'); -- 2024-05-18 14:30:45
STR_TO_DATE('18/05/2024', '%d/%m/%Y') -- 2024-05-18
STR_TO_DATE('20240518143045', '%Y%m%d%H%i%s')
DATEDIFF('2024-12-31', '2024-05-18') -- 227 天
TIMEDIFF('18:00:00', '14:30:45') -- '03:29:15'
TIMESTAMPDIFF(DAY, '2024-05-18', '2024-12-31') -- 227 (可指定單位)
PERIOD_ADD(202405, 3) -- 202408 (YYYYMM 格式加月)
PERIOD_DIFF(202408, 202405) -- 3 (月份差)
-- 本月第一天 00:00:00
SELECT DATE_FORMAT(NOW(), '%Y-%m-01 00:00:00');
-- 本月最後一天 23:59:59
SELECT DATE_SUB(DATE_ADD(DATE_FORMAT(NOW(), '%Y-%m-01'), INTERVAL 1 MONTH), INTERVAL 1 SECOND);
TIMESTAMPADD/TIMESTAMPDIFF 更精確處理時區NOW() 在儲存函數/觸發器中返回啟動時固定值,動態場景請用 SYSDATE()CONVERT_TZ()、NOW() 等,請確認 time_zone 系統變數