DateDiff 函數
返回Variant (Long) 的值,表示兩個指定日期間的時間間隔數目。
語法DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]])
DateDiff 函數語法中有下列命名參數:
部分描述interval 必要。字符串表達式,表示用來計算date1 和date2 的時間差的時間間隔
Date1□date2 必要;Variant (Date)。計算中要用到的兩個日期。
Firstdayofweek 可選。指定一個星期的第一天的常數。如果未予指定,則以星期日為第一天。
firstweekofyear 可選。指定一年的第一周的常數。如果未予指定,則以包含1 月1 日的星期為第一周。
設置interval 參數的設定值如下:(設置描述)
yyyy 年
q 季
m 月
y 一年的日數
d 日
w 一周的日數
ww 週
h 時
n 分鐘
s 秒
firstdayofweek 參數的設定值如下: (常數值描述)
vbUseSystem 0 使用NLS API 設置。
vbSunday 1 星期日(缺省值)
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
常數值描述
vbUseSystem 0 用NLS API 設置。
vbFirstJan1 1 從包含1 月1 日的星期開始(缺省值)。
vbFirstFourDays 2 從第一個其大半個星期在新的一年的一周開始。
vbFirstFullWeek 3 從第一個無跨年度的星期開始。
說明:
DateDiff 函數可用來決定兩個日期之間所指定的時間間隔數目。例如,可以使用DateDiff 來計算兩個日期之間相隔幾日,或計算從今天起到年底還有多少個星期。 為了計算date1 與date2 相差的日數,可以使用一年的日數(y) 或日(d)。當interval 是一周的日數(w) 時,DateDiff 返回兩日期間的周數。如果date1 是星期一,DateDiff 計算到date2 為止的星期一的個數。這個數包含date2 但不包含date1。不過,如果interval 是周(ww),則DateDiff 函數返回兩日期間的日曆週數。由計算date1 與date2 之間星期日的個數而得。如果date2 剛好是星期日,則date2 也會被加進DateDiff 的計數結果中;但不論date1 是否為星期日,都不將它算進去。 如果date1 比date2 來得晚,則DateDiff 函數的返回值為負數。 firstdayofweek 參數會影響使用時間間隔符號W 或WW 計算的結果。 如果date1 或date2 是日期文字,則指定的年份成為該日期的固定部分。但是,如果date1 或date2 用雙引號(" ") 括起來,且年份略而不提,則在每次計算表達式date1 或date2 時,當前年份都會插入到代碼之中。這樣就可以書寫適用於不同年份的程序代碼。 在計算12 月31 日和來年的1 月1 日的年份差時,DateDiff 返回1 表示相差一個年份,雖然實際上只相差一天而已。