返回给定日期的指定部分。
DatePart(interval, date[, firstdayofweek[, firstweekofyear]])
Arguments
interval
必选项。字符串表达式表示要返回的时间间隔。有关数值,请参阅“设置”部分。
Date
必选项。要计算的日期表达式。
firstdayof week
可选项。指定星期中的第一天的常数。如果没有指定,则默认为星期日。有关数值,请参阅“设置”部分。
Firstweekofyear
可选项。指定一年中第一周的常数。如果没有指定,则默认为 1 月 1 日所在的星期。有关数值,请参阅“设置”部分。
设置
interval 参数可以有以下值:
设置 |
描述 |
yyyy |
年 |
q |
季度 |
m |
月 |
y |
一年的日数 |
d |
日 |
w |
一周的日数 |
ww |
周 |
h |
小时 |
n |
分钟 |
s |
秒 |
firstdayofweek 参数可以有以下值:
常数 |
值 |
描述 |
vbUseSystem |
0 |
使用区域语言支持 (NLS) API 设置。 |
vbSunday |
1 |
星期日(默认) |
vbMonday |
2 |
星期一 |
vbTuesday |
3 |
星期二 |
vbWednesday |
4 |
星期三 |
vbThursday |
5 |
星期四 |
vbFriday |
6 |
星期五 |
vbSaturday |
7 |
星期六 |
firstweekofyear 参数可以有以下值:
常数 |
值 |
描述 |
vbUseSystem |
0 |
使用区域语言支持 (NLS) API 设置。 |
vbFirstJan1 |
1 |
由 1 月 1 日所在的星期开始(默认)。 |
vbFirstFourDays |
2 |
由在新年中至少有四天的第一周开始。 |
vbFirstFullWeek |
3 |
由在新的一年中第一个完整的周(不跨年度)开始。 |
说明
DatePart 函数用于计算日期并返回指定的时间间隔。例如使用 DatePart 计算某一天是星期几或当前的时间。
firstdayofweek 参数会影响使用“w”和“ww”间隔符号的计算。
如果 date 是日期文字,则指定的年度会成为日期的固定部分。但是如果 date 被包含在引号 (" ") 中,并且省略年份,则在代码中每次计算 date 表达式时,将插入当前年份。这样就可以编写适用于不同年份的程序代码。.
下面的示例利用 DatePart 函数获得日期并显示该日所在的季节。
Function GetQuarter(TheDate)
GetQuarter = DatePart("q", TheDate)
End Function