在 SQL Server 開發中,時間函數是處理日期與時間資料不可或缺的工具,無論是初始化賦值、複雜查詢邏輯,還是報表統計,熟練掌握這些函數能大幅提升開發效率。本文系統整理 SQL Server 核心時間函數的語法、參數與實戰範例,助你快速上手。
GETDATE() 為最基礎且常用的函數,回傳目前資料庫系統的日期與時間(精確到毫秒),資料型別為 datetime。
SELECT GETDATE(); -- 範例輸出:2023-10-25 14:30:45.123
DATENAME 依指定的日期部分(datepart)回傳對應的字串名稱(如月份名稱、星期名稱)。
| datepart | 說明 | 範例 (假設今日 2009-02-24 星期二) |
|---|---|---|
| year, yy, yyyy | 年份 | SELECT DATENAME(year, GETDATE()) → 2009 |
| month, mm, m | 月份 | SELECT DATENAME(month, GETDATE()) → 二月 |
| weekday, dw | 星期 | SELECT DATENAME(weekday, GETDATE()) → 星期二 |
| day, dd, d | 日 | SELECT DATENAME(day, GETDATE()) → 24 |
在指定日期上加減一段時間,回傳新的 datetime 值。number 可為正數(未來)或負數(過去)。
-- 日期加 2 個月
SELECT DATEADD(month, 2, '2008-08-08'); -- 2008-10-08 00:00:00.000
-- 日期加 2 天
SELECT DATEADD(day, 2, '2008-08-08'); -- 2008-08-10 00:00:00.000
-- 取得前一小時的時間
SELECT DATEADD(hour, -1, GETDATE());
回傳兩個日期之間指定日期部分的整數差距(enddate - startdate)。結果為有號整數。
-- 僅跨越 1 個小時邊界 (4:00 -> 5:00),雖然實際僅 1 小時 50 分
SELECT DATEDIFF(hour, '4:00AM', '5:50AM'); -- 返回 1
-- 跨越 102 個月份邊界
SELECT DATEDIFF(month, '1987/05/02', '1995/11/15'); -- 返回 102
-- 同一天內 (00:00 到 23:59),未跨越天邊界
SELECT DATEDIFF(day, '00:00', '23:59'); -- 返回 0
-- 19 到 23 日,跨越 4 個天邊界
SELECT DATEDIFF(day, '1999/07/19 00:00', '1999/07/23 23:59'); -- 返回 4
-- 同一月份內,未跨越月邊界
SELECT DATEDIFF(month, '1999/07/19', '1999/07/23'); -- 返回 0
-- 跨越 1 個月邊界 (7月 -> 8月)
SELECT DATEDIFF(month, '1999/07/19', '1999/08/23'); -- 返回 1
SELECT * FROM TableName
WHERE DATEDIFF(day, F_EditTime, GETDATE()) = 0;
DATEPART 功能類似 DATENAME,但回傳整數,適合用於數值運算或條件判斷。
SELECT DATEPART(year, GETDATE()) AS Year; -- 2009
SELECT DATEPART(month, GETDATE()) AS Month; -- 2
SELECT DATEPART(weekday, GETDATE()) AS Weekday; -- 3 (預設 Sunday=1, Saturday=7)
SELECT DAY(GETDATE()); -- 24 (DATEPART(day, date) 同義詞)
SELECT MONTH(GETDATE()); -- 2 (DATEPART(month, date) 同義詞)
SELECT YEAR(GETDATE()); -- 2009 (DATEPART(year, date) 同義詞)

掌握這五大核心函數(GETDATE、DATENAME、DATEADD、DATEDIFF、DATEPART)及其 datepart 參數,即可應付絕大多數 SQL Server 日期時間處理需求。建議實務上多搭配 DATEDIFF 進行篩選(如「最近 7 天」、「本月」),並善用 DATEADD 計算動態時間區間,寫出高效能、可維護的 T-SQL 程式碼。