DATEADD 函数

DATEADD 函数为具有日期类型的匹配属性执行时间和日期计算。 使用 DATEADD 函数可获取当前之前的指定时间段内的日期和时间。

语法

DATEADD (DateTimeUnits, OffsetValue, DateTime)

参数

DateTimeUnits

指定 DateTime 参数的单位:YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE 或 SECOND。 此值区分大小写,参数周围不需要引号。

OffsetValue

指定时间偏移量,以 DateTimeUnits 参数指定的单位为单位。 OffsetValue 必须是负整数。 不支持正值。

DateTime

指定要从中计算偏移量的时间戳。 这不能是日期文本。 它必须是 GETGMTDATE 或其他 DATEADD 函数的结果。

备注

DATEADD 函数只能在文本值比较中使用,只能在比较运算符的右侧使用。

GETGMTDATE 函数返回格林威治标准时间 (格林威治标准时间) 的当前日期和时间。 请记住,此值可能与计算机的本地时间不同。

请勿使用等于 (=) 比较运算符,因为内部时间表示形式可能会产生舍入错误,从而导致意外的匹配结果。

可以使用多个 DATEADD 函数来组合偏移单位。

示例

以下示例 WHERE 子句匹配过去五天内修改的文档:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

以下示例 WHERE 子句匹配在过去两天和四小时内修改的文档:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

参考

文本值比较

多值 (ARRAY) 比较

概念性

全文谓词

非全文谓词