DateSerial 函数

应用对象
Microsoft 365 专属 Access Access 2024 Access 2021 Access 2019 Access 2016

返回指定年、月和日的 Variant (Date) 类型的值。

语法

DateSerial (年、月、日)

警告 确保参数位于正确的值范围内。 无效参数可能会导致不正确的结果。

DateSerial 函数语法具有以下参数:

参数 说明
year 必需。 整数。 介于 100 和 9999 之间的数字(含)或数字表达式。
month 必需。 整数。 任何数值表达式。
必需。 整数。 任何数值表达式。

备注

若要指定日期(如 1991 年 12 月 31 日),每个 DateSerial 参数的数字范围应位于单位接受的范围内;也就是说,1-31 天和 1-12 个月。 但是,您也可以使用表示特定日期之前或之后的天数、月数或年数的任何数值表达式为每个参数指定相对日期。

以下示例使用数字表达式而不是绝对日期数字。 这里, DateSerial 函数返回的日期是) (1 - 1 第一天的前一天,即) 年 8 月 (8 - 2 日前两个月,即 1990 (1990 - 10) 10 年前;也就是说,1980 年 5 月 31 日。

DateSerial(1990 - 10, 8 - 2, 1 - 1)

year 参数的两位数年份根据用户定义的计算机设置进行解释。 默认设置是介于 0 和 29 之间的值(含)将解释为 2000-2029 年。 30 到 99 之间的默认值将解释为 1930-1999 年。 对于所有其他 年份 参数,请使用四位数的年份 (,例如 1800) 。

早于 Windows 2000 的 Windows 版本根据上述默认值解释两位数年份。 若要确保函数返回正确的值,请使用四位数年份。

当任意参数超出该参数的接受范围时,它将根据需要递增到下一个较大的单位。 例如,如果指定 35 天,则它将被评估为一个月和一些天数,具体取决于它在一年中的哪个位置应用。 如果任一参数超出 -32,768 到 32,767 的范围,则会出现错误。 如果三个参数指定的日期超出可接受的日期范围,则会出现错误。

注意

对于,如果 Calendar 属性设置为公历,则假定提供的值为公历。 如果 Calendar 属性设置为 Hijri,则假定提供的值为 Hijri。

返回的日期部分采用当前 Visual Basic 日历的时间段单位。 例如,如果当前日历是回历,并且要返回的日期部分是年份,则年值为回历年。 对于参数 年份,介于 0 和 99 之间的值(含)将解释为 1400-1499 年。 对于所有其他 年份 值,请使用完整的四位数年份 (,例如 1520) 。

查询示例

Expression 结果
SELECT Dateserial (2018,12,13) AS NewDate FROM ProductSales; 返回函数参数中输入的指定年、月、日的“日期”,显示在“NewDate”列中。 结果:“13/12/2018”。

VBA 示例

注意

下面的示例演示了在Visual Basic for Applications (VBA) 模块中使用此函数。 有关使用 VBA 的详细信息,请在“搜索”旁边的下拉列表中选择“开发人员参考”,然后在搜索框中输入一个或多个术语。

此示例使用 DateSerial 函数返回指定年、月和日的日期。

Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.

选择正确的日期函数