引數
間隔類型引數是一個字串運算式,指定即將加入的時間間隔。
n 個間隔引數是數字或數值運算式,指定即將加入的間隔數。它可以是正數 (取得未來的日期時間) 或負數 (取得過去的日期時間)。
引數值
IntervalType 值可以是下列其中一種︰
| |
|---|
| |
| |
| |
| 每年的第幾天 (1 到 365,閏年則是 366) |
| |
| 每星期的第幾天 (1 到 7,結果依據每週的第一天而定) |
| 每年的第幾週 (1 到 53,並且由每週的第一天與每年的第一週決定每年第一個日曆週確實是哪幾天) |
| |
| |
| |
動作
DateAdd 傳回已加入指定時間間隔數的日期時間值。
典型用法
DateAdd 是用來將時間間隔加入日期時間。它最主要功能是傳回的日期時間一定有效。例如,DateAdd 會考慮許多因素,如每月天數與閏年等。如果要將日期時間值加、減幾天,可以利用加法與減法運算子,而不必使用 DateAdd 與 "d" 參數。但是,DateAdd 也會處理其他種類的間隔,例如將日期時間值加上幾個月或幾小時。
範例
DateAdd("d", -32, #Sept 28, 1999#)傳回日期時間值 August 27, 1999。
DateAdd ("m", 1, #1/31/1996#)傳回日期時間值 February 29, 1996。請注意,DateAdd 不會傳回無效值 February 31, 1996。
DateAdd ("q", 17, #Sept 28, 1999#)傳回日期時間值 December 28, 2003。
DateAdd ("h", -400, #Sept 28, 1999#)傳回日期時間值 September 11, 1999 8:00 AM。換句話說,這是從 September 28, 1999 12:00 AM. 減去 400 個小時後的結果。
註解
若要將日期時間加上幾天,您可以使用 "y"、"d" 或 "w" 中任何一種間隔類型參數。對 DateAdd 而言,它們的效果都一樣。
DateAdd 傳回日期時間值,而非日期時間值。但是在某些情況下,您可能必須將這個日期時間值轉換成日期值 (例如要將 DateAdd 的傳回值指定給 Date 型別的變數)。若要轉換成日期值,可將 DateAdd 與 CDate 型別轉換函式搭配在一起使用。例如,下列範例傳回日期值 October 6, 1997:
CDate(DateAdd("yyyy", -2, #October 6, 1999#))