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