DateAdd(interval, number, date) 是 VBScript 核心日期運算函數,支持年/季/月/周/日/時/分/秒等多粒度加減運算,自動處理月份天數差異、閏年邊界。本文詳細列出所有間隔單位、參數規則、邊界行為、與 SQL Server 的關鍵差異。
DateAdd(interval, number, date)
' interval: String 間隔單位(見下表)
' number: Numeric 間隔數量,正數=未來,負數=過去,非整數四捨五入
' date: Variant 日期時間值(Date/字符串/數字)
| 間隔 | 代碼 | 說明 | 示例:DateAdd(interval, 1, "2023-01-31") |
|---|---|---|---|
| 年 | yyyy | 年份增減 | 2024-01-31 |
| 季度 | q | 3個月為一季 | 2023-04-30 |
| 月 | m | 月份增減,自動調整月末日 | 2023-02-28 (非閏年) |
| 一年中的天 | y | 同 'd' | 2023-02-01 |
| 天 | d | 日期增減 | 2023-02-01 |
| 工作日 | w | 僅計算周一至周五(VBScript 不支持,需自行實現) | N/A |
| 周 | ww | 7天為一周 | 2023-02-07 |
| 小時 | h | 小時增減 | 2023-01-31 01:00:00 |
| 分鐘 | n | 分鐘增減 | 2023-01-31 00:01:00 |
| 秒 | s | 秒增減 | 2023-01-31 00:00:01 |
' 1月31日 + 1個月 → 2月28日/29日(非閏年/閏年)
Response.Write DateAdd("m", 1, "2023-01-31") ' 2023-02-28
Response.Write DateAdd("m", 1, "2024-01-31") ' 2024-02-29 (閏年)
' 3月31日 + 1個月 → 4月30日
Response.Write DateAdd("m", 1, "2023-03-31") ' 2023-04-30
' 負數:往前推
Response.Write DateAdd("m", -1, "2023-03-31") ' 2023-02-28
規則:目標月無對應日時,自動調整為該月最後一天。**不會拋錯,不會跨月多天**。
' 1. 計算有效期/到期日
expireDate = DateAdd("m", 12, registerDate) ' 一年後
' 2. 統計周期邊界
weekStart = DateAdd("ww", -1, Date()) ' 一周前
monthStart = DateAdd("m", -1, Date()) ' 一月前
' 3. 排程任務:下次運行時間
nextRun = DateAdd("n", 30, Now()) ' 30分鐘後
' 4. 年齡計算(年齡 = 年份差 - 未過生日調整)
Function CalcAge(birthDate)
Dim age : age = DateDiff("yyyy", birthDate, Date())
If DateAdd("yyyy", age, birthDate) > Date() Then age = age - 1
CalcAge = age
End Function
| 差異點 | VBScript DateAdd | SQL Server DATEADD |
|---|---|---|
| 間隔單位字符串 | "yyyy", "m", "d", "h", "n", "s"... | year/yy, month/mm, day/dd, hour/hh, minute/mi, second/ss... |
| weekday (w) | 不支持(僅 w=周、ww=周) | 支持 weekday/dw (日歷週) |
| number 類型 | Numeric (自動四捨五入) | Int (隱式轉換,截斷小數) |
| date 參數 | Variant (靈活) | date/datetime/smalldatetime 類型 |
| 返回類型 | Date (Variant Date) | 與 date 參數同類型 |
| 閏秒處理 | 忽略 | 忽略 |
-- VBScript
DateAdd("m", 1, "2023-01-31") ' 2023-02-28
-- SQL Server
DATEADD(month, 1, '2023-01-31') -- 2023-02-28 (行為一致)
DATEADD(day, 1, '2023-12-31') -- 2024-01-01
number 過大導致溢出同樣報錯。date 為 Null → 錯誤;為空字符串 → 類型不匹配。' 統一入口:支持所有 VBScript 間隔代碼,異常返回 Null
Function SafeDateAdd(interval, number, dt)
On Error Resume Next
If Not IsDate(dt) Then SafeDateAdd = Null : Exit Function
SafeDateAdd = DateAdd(interval, number, CDate(dt))
If Err.Number <> 0 Then SafeDateAdd = Null : Err.Clear
End Function
' 通用日期格式化輸出(不依賴系統區域設置)
Function FormatDT(dt, fmt)
' fmt: "YYYY-MM-DD HH:NN:SS" 等,簡易實現
If Not IsDate(dt) Then FormatDT = "" : Exit Function
Dim y,m,d,h,n,s
y = Year(dt): m = Month(dt): d = Day(dt)
h = Hour(dt): n = Minute(dt): s = Second(dt)
fmt = Replace(fmt, "YYYY", y)
fmt = Replace(fmt, "MM", Right("0"&m,2))
fmt = Replace(fmt, "DD", Right("0"&d,2))
fmt = Replace(fmt, "HH", Right("0"&h,2))
fmt = Replace(fmt, "NN", Right("0"&n,2))
fmt = Replace(fmt, "SS", Right("0"&s,2))
FormatDT = fmt
End Function
DateAdd 是日期運算的基石,掌握其邊界行為與跨平台差異,能避免 90% 的日期 Bug。