VBA函数:DateDiff
两个指定日期间的时间间隔数目的VBA函数:DateDiff
返回 Variant (Long) 的值,表示两个指定日期间的时间间隔数目。
语法
DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]])
DateDiff 函数语法中有下列命名参数:
参数
描述
interval
必要。字符串表达式,表示用来计算date1 date2 的时间差的时间间隔
Date1date2
必要;Variant (Date)。计算中要用到的两个日期
Firstdayofweek
可选。指定一个星期的第一天的常数。如果未予指定,则以星期日为第一天;
firstweekofyear
可选。指定一年的第一周的常数。如果未予指定,则以包含 1 1 日的星期为第一周。
设置
interval 参数的设定值如下:
datediff是字符型函数
设置
描述
yyyy
q
m
y
一年的日数
d
w
一周的日数
ww
h
n
s
firstdayofweek 参数的设定值如下:
常数
描述
vbUseSystem
0
使用 NLS API 设置
vbSunday
1
星期日(缺省值)
vbMonday
2
星期一
vbTuesday
3
星期二
vbWednesday
4
星期三
vbThursday
5
星期四
vbFriday
6
星期五
vbSaturday
7
星期六
常数
描述
vbUseSystem
0
用 NLS API 设置
vbFirstJan1
1
从包含 1 月 1 日的星期开始(缺省值)。
vbFirstFourDays
2
从第一个其大半个星期在新的一年的一周开始
vbFirstFullWeek
3
从第一个无跨年度的星期开始。
说明
DateDiff 函数可用来决定两个日期之间所指定的时间间隔数目。例如,可以使用 DateDiff 来计算两个日期之间相隔几日,或计算从今天起到年底还有多少个星期。
为了计算 date1 date2 相差的日数,可以使用“一年的日数”(y) 或“日”(d)。当 interval 是“一周的日数”(w) 时,DateDiff 返回两日期间的周数。如果 date1 是星期一,DateDiff 计算到 date2 为止的星期一的个数。这个数包含 date2 但不包含 date1。不过,如果 interval 是“周”(ww),则 DateDiff 函数返回两日期间的“日历周”数。由计算 date1 date2 之间星期
日的个数而得。如果 date2 刚好是星期日,则 date2 也会被加进 DateDiff 的计数结果中;但不论 date1 是否为星期日,都不将它算进去。
如果 date1 date2 来得晚,则 DateDiff 函数的返回值为负数。firstdayofweek 参数会影响使用时间间隔符号 W WW 计算的结果。
如果 date1 date2 是日期文字,则指定的年份成为该日期的固定部分。但是,如果 date1 date2 用双引号 (" ") 括起来,且年份略而不提,则在每次计算表达式 date1 date2 时,当前年份都会插入到代码之中。这样就可以书写适用于不同年份的程序代码。
在计算 12 31 日和来年的 1 1 日的年份差时,DateDiff 返回 1 表示相差一个年份,虽然实际上只相差一天而已。
DateDiff 函数示例
本示例使用 DateDiff 函数来显示某个日期与今日相差几天。
Dim TheDate As Date    ' 声明变量。
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。