?

關(guān)鍵詞

DateDiff

?

摘要

描述

返回兩個日期之間的時間間隔。

語法

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

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

描述

返回兩個日期之間的時間間隔。

語法

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

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

?

參數(shù)

描述

interval

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

date1, date2

必選。日期表達(dá)式。用于計算的兩個日期。

firstdayofweek

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

firstweekofyear

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

?

設(shè)置

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

?

設(shè)置

描述

yyyy

年

q

季度

n

月

y

一年的日數(shù)

d

日

w

一周的日數(shù)

ww

周

h

小時

m

分鐘

s

秒

?

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

?

常數(shù)

值

描述

vbUseSystem

0

使用區(qū)域語言支持 (NLS) API 設(shè)置。

vbSunday

1

星期日（默認(rèn)）

vbMonday

2

星期一

vbTuesday

3

星期二

vbWednesday

4

星期三

vbThursday

5

星期四

vbFriday

6

星期五

vbSaturday

7

星期六

?

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

?

常數(shù)

值

描述

vbUseSystem

0

使用區(qū)域語言支持 (NLS) API 設(shè)置。

vbFirstJan1

1

由 1 月 1 日所在的星期開始（默認(rèn)）。

vbFirstFourDays

2

由在新年中至少有四天的第一周開始。

vbFirstFullWeek

3

由在新的一年中第一個完整的周開始。

?

說明

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

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

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

firstdayofweek?參數(shù)會對使用“w”和“ww”間隔符號的計算產(chǎn)生影響。

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

在?interval?為“年”（“yyyy”）時，比較 12 月 31 日和來年的 1 月 1 ?日，雖然實際上只相差一天，DateDiff?返回 1 表示相差一個年份。

下面例子利用?DateDiff?函數(shù)顯示給定日期和當(dāng)天日期之間的天數(shù): ?

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

?

?