DateDiff 函數(shù)

返回兩個(gè)日期之間的時(shí)間間隔。

DateDiff(interval, date1, date2 [,firstdayofweek[, firstweekofyear]])

DateDiff 函數(shù)的語(yǔ)法有以下參數(shù)：

參數(shù)

interval

必選項(xiàng)。String expression 表示用于計(jì)算 date1 和 date2 之間的時(shí)間間隔。有關(guān)數(shù)值，請(qǐng)參閱“設(shè)置”部分。

date1, date2

必選項(xiàng)。日期表達(dá)式。用于計(jì)算的兩個(gè)日期。

Firstdayofweek

可選項(xiàng)。指定星期中第一天的常數(shù)。如果沒(méi)有指定，則默認(rèn)為星期日。有關(guān)數(shù)值，請(qǐng)參閱“設(shè)置”部分。

Firstweekofyear

可選項(xiàng)。指定一年中第一周的常數(shù)。如果沒(méi)有指定，則默認(rèn)為 1 月 1 日所在的星期。有關(guān)數(shù)值，請(qǐng)參閱“設(shè)置”部分。

設(shè)置

interval 參數(shù)可以有以下值：

firstdayofweek 參數(shù)可以有以下值：

firstweekofyear 參數(shù)可以有以下值：

說(shuō)明

DateDiff 函數(shù)用于判斷在兩個(gè)日期之間存在的指定時(shí)間間隔的數(shù)目。例如可以使用 DateDiff 計(jì)算兩個(gè)日期相差的天數(shù)，或者當(dāng)天到當(dāng)年最后一天之間的星期數(shù)。

要計(jì)算 date1 和 date2 相差的天數(shù)，可以使用“一年的日數(shù)”（“y”）或“日”（“d”）。當(dāng) interval 為“一周的日數(shù)”（“w”）時(shí)，DateDiff 返回兩個(gè)日期之間的星期數(shù)。如果 date1 是星期一，則 DateDiff 計(jì)算到 date2 之前星期一的數(shù)目。此結(jié)果包含 date2 而不包含 date1。如果 interval 是“周”（“ww”），則 DateDiff 函數(shù)返回日歷表中兩個(gè)日期之間的星期數(shù)。函數(shù)計(jì)算 date1 和 date2 之間星期日的數(shù)目。如果 date2 是星期日，DateDiff 將計(jì)算 date2，但即使 date1 是星期日，也不會(huì)計(jì)算 date1。

如果 date1 晚于 date2，則 DateDiff 函數(shù)返回負(fù)數(shù)。

firstdayofweek 參數(shù)會(huì)對(duì)使用“w”和“ww”間隔符號(hào)的計(jì)算產(chǎn)生影響。

如果 date1 或 date2 是日期文字，則指定的年度會(huì)成為日期的固定部分。但是如果 date1 或 date2 被包括在引號(hào) (" ") 中并且省略年份，則在代碼中每次計(jì)算 date1 或 date2 表達(dá)式時(shí)，將插入當(dāng)前年份。這樣就可以編寫(xiě)適用于不同年份的程序代碼。

在 interval 為“年”（“yyyy”）時(shí)，比較 12 月 31 日和來(lái)年的 1 月 1 日，雖然實(shí)際上只相差一天，DateDiff 返回 1 表示相差一個(gè)年份。

下面的示例利用 DateDiff 函數(shù)顯示今天與給定日期之間間隔天數(shù):

Function DiffADate(theDate)  DiffADate = "從當(dāng)天開(kāi)始的天數(shù):" & DateDiff("d", Now, theDate)End Function