DateDiff函數描述
返回兩個日期之間的時間間隔。
DateDiff(interval,date1,date2[,firstdayofweek][,firstweekofyear]])
DateDiff函數的語法有以下參數:
參數描述
interval必選。字符串表達式,表示用於計算date1和date2之間的時間間隔。有關數值,請參閱“設置”部分。
date1,date2必選。日期表達式。用於計算的兩個日期。
firstdayofweek可選。指定星期中第一天的常數。如果沒有指定,則默認爲星期日。有關數值,請參閱“設置”部分。
firstweekofyear可選。指定一年中第一週的常數。如果沒有指定,則默認爲1月1日所在的星期。有關數值,請參閱“設置”部分。
設置
interval參數可以有以下值:
設置描述
yyyy 年
q 季度
m 月
y 一年的日數
d 日
w 一週的日數
ww 周
h 小時
m 分鐘
s 秒
firstdayofweek參數可以有以下值:
常數值描述
vbUseSystem0使用區域語言支持(NLS)API設置。
vbSunday1星期日(默認)
vbMonday2星期一
vbTuesday3星期二
vbWednesday4星期三
vbThursday5星期四
vbFriday6星期五
vbSaturday7星期六
firstweekofyear參數可以有以下值:
常數值描述
vbUseSystem0使用區域語言支持(NLS)API設置。
vbFirstJan11由1月1日所在的星期開始(默認)。
vbFirstFourDays2由在新年中至少有四天的第一週開始。
vbFirstFullWeek3由在新的一年中第一個完整的周開始。
說明
DateDiff函數用於判斷在兩個日期之間存在的指定時間間隔的數目。例如可以使用DateDiff計算兩個日期相差的天數,或者當天到當年最後一天之間的星期數。
要計算date1和date2相差的天數,可以使用“一年的日數”(“y”)或“日”(“d”)。當interval爲“一週的日數”(“w”)時,DateDiff返回兩個日期之間的星期數。如果date1是星期一,則DateDiff計算到date2之前星期一的'數目。此結果包含date2而不包含date1。如果interval是“周”(“ww”),則DateDiff函數返回日曆表中兩個日期之間的星期數。函數計算date1和date2之間星期日的數目。如果date2是星期日,DateDiff將計算date2,但即使date1是星期日,也不會計算date1。
如果date1晚於date2,則DateDiff函數返回負數。
firstdayofweek參數會對使用“w”和“ww”間隔符號的計算產生影響。
如果date1或date2是日期文字,則指定的年度會成爲日期的固定部分。但是如果date1或date2被包括在引號("")中並且省略年份,則在代碼中每次計算date1或date2表達式時,將插入當前年份。這樣就可以編寫適用於不同年份的程序代碼。在interval爲“年”(“yyyy”)時,比較12月31日和來年的1月1日,雖然實際上只相差一天,DateDiff返回1表示相差一個年份。