日期時間處理是業務開發的高頻需求。SQL Server 提供豐富的函數族群:取得當前時間、日期運算、差值計算、部份擷取、格式化轉換。本文系統整理核心函數語法、常用範例與格式化代碼對照表。
SELECT GETDATE(); -- 當前資料庫系統日期時間 (精度 3.33ms)
SELECT SYSDATETIME(); -- 高精度 (100ns),SQL 2008+
SELECT SYSUTCDATETIME(); -- UTC 高精度時間
在指定日期加減間隔,回傳新 datetime / datetime2。
DATEADD(datepart, number, date)
-- 常用 datepart: year/yy/yyyy, quarter/qq/q, month/mm/m, dayofyear/dy/y, day/dd/d, week/wk/ww, weekday/dw, hour/hh, minute/mi/n, second/ss/s, millisecond/ms, microsecond/mcs, nanosecond/ns
SELECT DATEADD(day, 2, '2004-10-15'); -- 2004-10-17 00:00:00.000
SELECT DATEADD(month, -3, GETDATE()); -- 3 個月前
SELECT DATEADD(hour, 8, GETUTCDATE()); -- UTC 轉 UTC+8
回傳兩日期間指定邊界跨越的**整數**數量 (非精確時長)。
DATEDIFF(datepart, startdate, enddate)
SELECT DATEDIFF(day, '2004-09-01', '2004-09-18'); -- 17
SELECT DATEDIFF(second, '2005-07-20', '2005-07-25 22:56:32'); -- 514592
SELECT DATEDIFF(week, '2024-01-01', GETDATE()); -- 今年第幾週
陷阱:
DATEDIFF(day, '2024-01-01 23:59', '2024-01-02 00:01')回傳 1 (跨越午夜邊界),實際僅 2 分鐘。精確時長請用DATEDIFF(second, ...) / 86400.0。
DATEPART(datepart, date) -- 回傳 INT
DATENAME(datepart, date) -- 回傳 NVARCHAR (月份名稱、星期名稱)
SELECT DATEPART(month, '2004-10-15'); -- 10
SELECT DATENAME(weekday, '2004-10-15'); -- 'Friday' (依語言設定)
SELECT DATENAME(week, '2004-10-15'); -- 年度週數 (21)
-- 簡易函數 (等同 DATEPART)
SELECT DAY(GETDATE()), MONTH(GETDATE()), YEAR(GETDATE());
CONVERT(data_type(length), date, style)
常用 Style 代碼對照表:
| Style | 輸出範例 | 格式描述 | 標準 |
|---|---|---|---|
| 112 | 20040912 | YYYYMMDD (ISO 日期) | ISO |
| 120 | 2004-09-12 11:06:08 | YYYY-MM-DD HH:MI:SS (ODBC 標準) | ODBC |
| 121 | 2004-09-12 11:06:08.177 | 含毫秒 (ODBC + 毫秒) | ODBC |
| 111 | 2004/09/12 | YYYY/MM/DD | 日本 |
| 102 | 2004.09.12 | YYYY.MM.DD | ANSI |
| 103 | 12/09/2004 | DD/MM/YYYY | 英式 |
| 104 | 12.09.2004 | DD.MM.YYYY | 德式 |
| 105 | 12-09-2004 | DD-MM-YYYY | 義式 |
| 106 | 12 09 2004 | DD Mon YYYY | |
| 107 | Sep 12, 2004 | Mon DD, YYYY | |
| 108 | 11:06:08 | HH:MI:SS | |
| 109 | Sep 12 2004 11:06:08:177AM | Mon DD YYYY HH:MI:SS:mmmAM | |
| 110 | 09-12-2004 | MM-DD-YYYY | 美式 |
| 113 | 12 Sep 2004 11:06:08:177 | DD Mon YYYY HH:MI:SS:mmm | 歐洲預設 |
| 114 | 11:06:08.177 | HH:MI:SS:mmm (24h) |
SELECT REPLACE(REPLACE(REPLACE(CONVERT(VARCHAR, GETDATE(), 120), '-', ''), ' ', ''), ':', '');
-- 20240115143025
SELECT FORMAT(GETDATE(), 'yyyy-MM-dd HH:mm:ss', 'zh-TW'); -- 2024-01-15 14:30:25
SELECT FORMAT(GETDATE(), 'yyyy年MM月dd日 dddd', 'zh-TW'); -- 2024年01月15日 星期一
-- 本月第一天 00:00:00
SELECT DATEADD(month, DATEDIFF(month, 0, GETDATE()), 0);
-- 本月最後一天 23:59:59.997
SELECT DATEADD(ms, -3, DATEADD(month, DATEDIFF(month, 0, GETDATE()) + 1, 0));
-- 近 3 天資料
SELECT * FROM Orders WHERE OrderDate >= DATEADD(day, -3, GETDATE());
-- 本年迄今 (YTD)
SELECT * FROM Sales WHERE OrderDate >= DATEADD(year, DATEDIFF(year, 0, GETDATE()), 0);
-- 年齡計算 (精確到生日)
SELECT FLOOR(DATEDIFF(day, BirthDate, GETDATE()) / 365.25) AS Age FROM Employees;
-- UTC 轉台北時間 (+08:00)
SELECT AT TIME ZONE 'UTC' AT TIME ZONE 'Taipei Standard Time';
-- 列出所有時區
SELECT * FROM sys.time_zone_info;
熟練運用日期時間函數,能讓報表、排程、業務邏輯精準高效地處理時間維度。