VBS教程：函数-DatePart 函数

datepart 函数

返回给定日期的指定部分。

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