VBA

-

VBA函数：DateDiff

两个指定日期间的时间间隔数目的VBA函数：DateDiff

返回 Variant (Long) 的值，表示两个指定日期间的时间间隔数目。

语法

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

DateDiff 函数语法中有下列命名参数：

参数 描述

interval

Date1，date2 必要；Variant (Date)。计算中要用到的两个日期

Firstdayofweek

必要。字符串表达式，表示用来计算date1 和 date2 的时间差的时间间隔

可选。指定一个星期的第一天的常数。如果未予指定，则以星期日为第一天；

firstweekofyear

可选。指定一年的第一周的常数。如果未予指定，则以包含 1 月 1 日的星期为

第一周。

设置

interval 参数的设定值如下：

设置 描述

yyyy

q

m

y

d

w

ww

h

n

s

firstdayofweek 参数的设定值如下：

常数 值 描述

vbUseSystem 0

vbSunday 1

vbMonday 2

vbTuesday 3

vbThursday 5

vbFriday 6

vbSaturday 7

使用 NLS API 设置

星期日（缺省值）

星期一

星期二

星期三

星期四

星期五

星期六

年

季

月

一年的日数

日

一周的日数

周

时

分

秒

vbWednesday 4

常数 值 描述

vbUseSystem 0

vbFirstJan1 1

用 NLS API 设置

从包含 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

-

datediff函数怎么用