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。