参数
intervalType 是一个字符串表达式,用来指定要添加的时间间隔。
nIntervals 是一个数字或数值表达式,用来指定要添加的间隔数。它可以为整数(以得到未来的日期时间),也可以为负数(以得到过去的日期时间)。
startDateTime 是一个要为其添加间隔的日期时间值。
参数值
IntervalType 值可为下列之一:
| |
|---|
| |
| |
| |
| 一年中的某天(从 1 到 365,闰年是从 1 到 366) |
| |
| 一周中的某天(1 到 7,其结果取决于 firstDayOfWeek) |
| 一年中的某周(1 到 53,firstDayOfWeek 和 firstWeekOfYear 确定一年中第一个日历周的确切天数) |
| |
| |
| |
操作
DateAdd 返回一个日期时间值,它添加了指定数目的时间间隔。
典型用法
DateAdd 用于给一个日期时间添加时间间隔。其主要特征在于所返回的日期时间始终是有效的。例如,DateAdd 考虑诸如月份中的天数和闰年这类因素。如果希望给一个日期时间添加或减去天数,可以使用加法或减法运算符来代替带有“d”参数的 DateAdd。然而,DateAdd 也处理其他类型的间隔(如给一个日期时间添加月份或小时)。
示例
DateAdd("d", -32, #Sept 28, 1999#)返回 August 27, 1999 的日期时间值。
DateAdd ("m", 1, #1/31/1996#)返回 1996 年 2 月 29 日的日期时间值。注意 DateAdd 将不会返回无效值 1996 年 2 月 31 日。
DateAdd ("q", 17, #Sept 28, 1999#)返回 December 28, 2003 的日期时间值。
DateAdd ("h", -400, #Sept 28, 1999#)返回 1999 年 9 月 11 日上午 8:00 的日期时间值。换言之,这是从 1999 年 9 月 28 日上午 12:00 减去 400 小时后的结果。
注释
若要向日期时间添加天数,可以使用下列任何一种间隔类型参数:“y”、“d”或“w”。它们对 DateAdd 有相同的效果。
DateAdd 返回的是日期时间值而非日期值。不过,在某些情况下,可能需要将该日期时间值转换成一个日期值(诸如在想把 DateAdd 返回的值赋给一个日期类型变量时)。要转换成日期值,须结合 CDate 类型转换函数一起使用 DateAdd。例如,下例返回 October 6, 1997 的日期值:
CDate(DateAdd("yyyy", -2, #October 6, 1999#))