datepart函数

DatePart

Basic 语法和 Crystal 语法。

重载

• DatePart (intervalType, inputDateTime)
• DatePart (intervalType, inputDateTime, firstDayOfWeek)
• DatePart (intervalType, inputDateTime, firstDayOfWeek, firstWeekOfYear)

参数

• intervalType 是一个字符串表达式，用来指定要返回的日期部分。可能的值为：

  间隔类型值	说明
  yyyy	提取年份
  q	季度（结果是 1、2、3 或 4）
  m	月（结果是从 1 到 12 之间的数)
  y	一年中的某天（从 1 到 365，闰年是从 1 到 366）
  d	日期的天部分（1 到 31）
  w	一周中的某天（1 到 7，其结果取决于 firstDayOfWeek）
  ww	一年中的某周（1 到 53，firstDayOfWeek 和 firstWeekOfYear 确定一年中第一个日历周的确切天数）
  h	提取给定日期时间的小时部分（0 到 23）
  n	分钟部分（0 到 59）
  s	秒钟部分（0 到 59）

• inputDateTime 是要从中提取部分内容的日期时间值。
• firstDayOfWeek 是一个可选常量，用于指定一周的第一天。如果没有指定，则使用 crSunday。有关更多信息，请参阅 周中日常量。
• firstWeekOfYear 是一个可选常量，用于指定一年中的第一周。如果未指定，则假定第一周是 1 月 1 日所在的周 (crFirstJan1)。请参阅每年的第一周常量。

返回

一个数字值。

操作

DatePart 返回一个数字，指定给定日期的给定部分。

示例

下列示例适用于 Basic 语法和 Crystal 语法：

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：

Rem Basic 语法

formula = CStr({订单.订单 ID}, 0, "") & "-" & _

            CStr(DatePart("ww", {订单.发货日期}), 0) & _

            CStr({订单.发货日期}, "yy")

//Crystal 语法

CStr({订单.订单 ID}, 0, "") & "-" &

     CStr(DatePart("ww", {订单.发货日期}), 0) &

     CStr({订单.发货日期}, "yy")

如果 {订单.订单 ID} 是 2082，{订单.发货日期} 是 1997 年 9 月 14 日，则返回字符串“2082 -3 897”。

注释

此函数的使用类似 Visual Basic 的同名函数。

带有“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 参数值，将其忽略。