返回一个 Variant (Integer) 值,其中包含给定日期的指定部分。

警告    使用此函数时存在问题。 某些日历年的最后一个星期一可以返回为第 53 周,该周应为第 1 周。 有关详细信息和解决方法,请参阅 Format 或 DatePart 函数可能返回年份中最后一个星期一的错误周数。

语法

DatePart ( interval, date [firstdayofweek] [ , firstweekofyear] )

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

参数

说明

interval

必需。 要返回的时间间隔的字符串表达式。

date

必需。 变量 () 的"日期"值。

firstdayofweek

可选。 一 常量 指定一周的第一天。 如果未指定,则假定为星期日。

firstweekofyear

可选。 一个常量,指定一年的第一周。 如果未指定,则第一周假定为 1 月 1 日发生的周。

设置

interval 参数 具有以下设置:

设置

说明

yyyy

年份

q

季度

m

y

一年中的一天

d

w

Weekday

ww

h

小时

n

分钟

s

firstdayofweek 参数具有以下设置:

常数

说明

vbUseSystem

0

使用 NLS API 设置。

vbSunday

1

星期日 (默认)

vbMonday

2

星期一

vbTuesday

3

星期二

vbWednesday

4

星期三

vbThursday

5

星期四

vbFriday

6

星期五

vbSaturday

7

星期六

一个weekofyear 参数具有以下设置:

常数

说明

vbUseSystem

0

使用 NLS API 设置。

vbFirstScript1

1

从 1 月 1 日 (星期开始) 。

vbFirstFourDays

2

从新一年的第一周开始,该周至少有四天。

vbFirstFullWeek

3

从一年的第一个整周开始。

备注

可以使用 DatePart 函数评估日期并返回特定的时间间隔。 例如,可以使用 DatePart 计算星期日期或当前小时。

一个dayofweek 参数会影响使用"w"和"ww"间隔符号的计算。

如果 date 是 日期字符串 ,则指定的年份将成为该日期的永久部分。 但是,如果日期用双引号 (" ") ,并且你省略了年份,则每次计算日期表达式时,在代码中插入当前年份。 这样,就可以编写可在不同年中使用的代码。

注意: 对于 日期,如果 "日历 "属性设置为公历,则提供的日期必须是公历。 如果日历是回历,则提供的日期必须是回历。

返回的日期部分是当前阿拉伯语日历的时间段单位。 例如,如果当前日历是回历,而要返回的日期部分是年份,则年值为回历年。

查询示例

表达式

结果

SELECT DatePart ("yyyy",[DateofSale]) AS NewDate FROM ProductSales;

返回字段"DateofSale"的日期值的"Year"。

SELECT DatePart ("q",[DateofSale]) AS NewDate FROM ProductSales;

基于日历年 (字段"DateofSale") 值返回"季度"值。

SELECT DatePart ("y",[DateofSale]) AS NewDate FROM ProductSales;

返回字段"DateofSale" (1 到 365) 的"年日期"值。

SELECT DatePart ("d",[DateofSale]) AS NewDate FROM ProductSales;

返回字段"DateofSale"的日期值的"Day"。

SELECT DatePart ("w",[DateofSale]) AS NewDate FROM ProductSales;

返回"Weekday" (1 到 7,其中 1 表示) 日期值"DateofSale"的日期值。

SELECT DatePart ("ww",[DateofSale]) AS NewDate FROM ProductSales;

返回字段"DateofSale" (1 到 52) 的"周数"值。

SELECT DatePart ("h",[DateTime]) AS NewDate FROM ProductSales;

返回字段"DateTime"的日期值的"Hour"。

SELECT DatePart ("n",[DateTime]) AS NewDate FROM ProductSales;

返回字段"DateTime"的日期值的"分钟"。

SELECT DatePart ("s",[DateTime]) AS NewDate FROM ProductSales;

返回字段"DateTime"的日期值的"秒"。

VBA 示例

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

此示例采用日期,使用 DatePart 函数显示发生日期的一年中的季度。

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

选择正确的日期函数

需要更多帮助?

扩展你的技能
了解培训
抢先获得新功能
加入 Microsoft 内部人员

此信息是否有帮助?

你对翻译质量的满意程度如何?
哪些因素影响了你的体验?

谢谢您的反馈意见!

×