说明
DatePart 返回一个数字,指定给定日期的给定部分。
重载
DatePart (intervalType, inputDateTime)
DatePart (intervalType, inputDateTime, firstDayOfWeek)
DatePart (intervalType, inputDateTime, firstDayOfWeek, firstWeekOfYear)
参数
intervalType 是一个字符串表达式,用来指定要返回的日期部分。
inputDateTime 是要从中提取部分内容的日期时间值。
firstDayOfWeek 是一个可选常量,用于指定一周的第一天。如果没有指定,则使用 crSunday。
firstWeekOfYear 是一个可选常量,用于指定一年中的第一周。如果未指定,则假定第一周是 1 月 1 日(crFirstJan1)。
参数值
IntervalType 值可为下列之一:
| |
|---|
| |
| |
| |
| 一年中的某天(从 1 到 365,闰年是从 1 到 366)
|
| |
| 一周中的某天(1 到 7,其结果取决于 firstDayOfWeek)
|
| 一年中的某周(1 到 53,firstDayOfWeek 和 firstWeekOfYear 确定一年中第一个日历周的确切天数)
|
| |
| |
| |
操作
DatePart 返回一个数字,指定给定日期的给定部分。
示例
DatePart ("d", #August 15, 1999#)返回 15。
DatePart ("m", #August 15, 1999#)返回 8。
DatePart ("n", #10:35 am#)返回 35。
DatePart ("q", #September 29, 1999#)返回 3,因为 9 月 29 日属于该年的第三个季度。
DatePart ("ww", #September 14, 1997#)返回 38,因为 1997 年 9 月 14 日属于 1997 年的第 38 周。
假定某家公司希望在其每件货物上标一个 id 号,以便于质量控制。此 id 由订单 id 后接一根短线、订单发运的周和年份的最后两位数字组成。如下示例公式产生这些 ID:
CStr({Orders.Order ID}, 0, "") & "-" &
CStr(DatePart("ww", {Orders.Ship Date}), 0) &
CStr({Orders.Ship Date}, "yy")
如果 {订单.订单 ID} 是 2082,{订单.发货日期} 是 1997 年 9 月 14 日,则返回字符串“2082-3897”。
注释
带有“yyyy”intervalType 参数的 DatePart 函数与 Year 函数相同。同样,带有“m”、“d”、“w”、“h”、“n”和“s”intervalType 参数的 DatePart 函数分别与 Month、Day、Weekday(或 DayOfWeek)、Hour、Minute 和 Second 函数相同。另一方面,对于“q”、“y”和“ww”intervalType 参数,除使用 DatePart 函数外没有其他简单的办法。
当间隔类型参数是“w”或“ww”时,firstDayOfWeek 参数会影响 DatePart 函数。对于所有其他 intervalType 参数值,将其忽略。
只有当 intervalType 参数是“ww”时,firstWeekOfYear 参数才影响 DatePart 函数。对于所有其他 intervalType 参数值,将其忽略。