萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

SQL Server 時間函數完整指南:GETDATE、DATENAME、DATEADD、DATEDIFF、DATEPART 詳解

在 SQL Server 開發中,時間函數是處理日期與時間資料不可或缺的工具,無論是初始化賦值、複雜查詢邏輯,還是報表統計,熟練掌握這些函數能大幅提升開發效率。本文系統整理 SQL Server 核心時間函數的語法、參數與實戰範例,助你快速上手。

1. 取得系統目前日期時間:GETDATE()

GETDATE() 為最基礎且常用的函數,回傳目前資料庫系統的日期與時間(精確到毫秒),資料型別為 datetime。

SELECT GETDATE(); -- 範例輸出:2023-10-25 14:30:45.123

2. 解析日期元件並回傳字串:DATENAME(datepart, date)

DATENAME 依指定的日期部分(datepart)回傳對應的字串名稱(如月份名稱、星期名稱)。

常用 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

3. 日期加減運算:DATEADD(datepart, number, date)

在指定日期上加減一段時間,回傳新的 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());

4. 計算兩日期差距:DATEDIFF(datepart, startdate, enddate)

回傳兩個日期之間指定日期部分的整數差距(enddate - startdate)。結果為有號整數。

關鍵行為與範例

  • 跨越邊界計數:只要跨越了單位邊界(如小時、月份),計數即 +1,不考慮實際時長是否滿足完整單位。
-- 僅跨越 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;

5. 解析日期元件並回傳整數:DATEPART(datepart, date)

DATEPART 功能類似 DATENAME,但回傳整數,適合用於數值運算或條件判斷。

範例 (假設今日 2009-02-24 星期二)

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) 同義詞)

附錄:常用 datepart 縮寫對照表

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

copyright © 萬盛學電腦網 all rights reserved