日期和时间函数
下面的列表显示了可在表达式中使用的日期和时间函数。
函数 | 说明 |
---|---|
DateAdd(Arg1, Arg2, Arg3) |
向 Date 、Time 或 DateTime 添加间隔。该方法可添加 TimeSpan 或表示指定日期或时间部分(例如,天数)的 Integer 。如果要添加 如果要向日期或时间部分添加整数值,则使用三个参数:Arg1 是一个字符串,说明要添加的部分。Arg2 是一个数字,其中包含要添加的部分数。Arg3 是 Arg1 的有效参数包括: “ “ “ “ “ “ “ “ “ “ “ 示例:
|
DateDiff(Arg1, Arg2, Arg3) |
计算两个 Date 、Time 或 DateTime 列之间的差。结果以 TimeSpan 或表示指定时间部分(例如天数)的实数值显示。如果使用了两个参数(开始日期列和停止日期列),则结果将是显示总体差的 如果使用了三个参数,则第一个参数应是要比较的部分。第二个参数是开始日期列,第三个参数是停止日期列。运算的结果为实数值。 Arg1 的有效参数包括: “ “ “ “ “ “ “ “ “ “ “ “ “ “ 示例:
|
DatePart(Arg1, Arg2) |
返回 Date 、Time 或 DateTime 的指定部分。Arg1 是说明要获取的日期部分的字符串,Arg2 是 Date 、Time 或 DateTime 列。计算的基础数据是 Integer ,但区域设置决定一些参数的格式化输出(“mm ”、“qq ”、“dw ”)。Arg1 的有效参数包括: “ “ “ “ “ “ “ “ “ “ “ “ “ “ 示例:
|
DateTimeNow() |
返回当前系统时间。 请注意,当在 Web 客户端中运行表达式或使用自动化服务时,返回的是服务(在服务器上)时区中的时间。 示例:
|
Day(Arg1) |
从 Date 或 DateTime 列中提取月中第几日。结果是介于 1 和 31 之间的整数。示例:
|
DayOfMonth(Arg1) |
从 Date 或 DateTime 列中提取月中第几日。结果是介于 1 和 31 之间的整数。示例:
|
DayOfWeek(Arg1) |
从 Date 或 DateTime 列中提取周中第几日。新列的基础数据是一个介于 0(星期日)到 6(星期六)之间的整数,但区域设置决定周的开始以及格式化输出。示例:
|
DayOfYear(Arg1) |
从 Date 或 DateTime 列中提取年中第几日。返回介于 1 和 366 之间的整数。示例:
|
Days(Arg1) |
返回 TimeSpan 对应的天数,介于 -10675199 和 10675199 之间的 Integer 值;或者,如果参数为 示例:
|
FiscalMonth(Arg1, Arg2) |
返回某日期所在的财政月。 第一个参数是 如果未指定第二个参数,则会使用文档属性 在层级中使用时, 图像中的层级可通过以下表达式构建:
示例:
|
FiscalQuarter (Arg1, Arg2) |
根据月份 (Arg2) 中指定的切换返回日期 (Arg1) 所在的财政季度。 第二个参数为可选项。如果未指定第二个参数,则会使用文档属性 示例:
|
FiscalYear (Arg1, Arg2) |
根据月份 (Arg2) 中指定的切换返回日期 (Arg1) 所在的财政年。 第二个参数为可选项。如果未指定第二个参数,则会使用文档属性 示例:
|
Hour(Arg1) |
从 DateTime 或 Time 列中提取小时。返回介于 0 和 23 之间的整数。示例:
|
Hours(Arg1) |
返回 TimeSpan 对应的小时数,介于 0 和 23 之间的 Integer 值;或者,如果参数为 示例:
|
ISOWeek(Arg1) |
为日期(Date 或 DateTime)返回 ISO 8601 格式的 ISO 周,返回值为介于 1 和 53 之间的整数。 示例:
|
ISOYear(Arg1) |
为日期(Date 或 DateTime)返回 ISO 8601 格式的 ISO 周数年,返回值为整数。 示例:
|
Millisecond(Arg1) |
从 DateTime 或 Time 列中提取毫秒。返回介于 0 和 999 之间的整数。示例:
|
Milliseconds(Arg1) |
返回 TimeSpan 对应的毫秒数,介于 0 和 999 之间的 Integer 值;或者,如果参数为 示例:
|
Minute(Arg1) |
从 DateTime 或 Time 列中提取分钟。返回介于 0 和 59 之间的整数。示例:
|
Minutes(Arg1) |
返回 TimeSpan 对应的分钟数,介于 0 和 59 之间的 Integer 值;或者,如果参数为 示例:
|
Month(Arg1) |
从 Date 或 DateTime 列中提取月。新列的基础数据为介于 1 和 12 之间的整数,但区域设置会确定格式化输出。示例:
|
Quarter(Arg1) |
从 Date 或 DateTime 列中提取季度。新列的基础数据为介于 1 和 4 之间的整数,但区域设置会确定格式化输出。示例:
|
Second(Arg1) |
从 DateTime 或 Time 列中提取秒。返回介于 0 和 59 之间的整数。示例:
|
Seconds(Arg1) |
返回 TimeSpan 对应的秒数,介于 0 和 59 之间的 Integer 值;或者,如果参数为 示例:
|
Today() |
返回当前日期。 请注意,当在 Web 客户端中运行表达式或使用自动化服务时,返回的是服务(在服务器上)时区中的日期。 示例:
|
TotalDays(Arg1) |
返回 TimeSpan 对应的天数,以整数天数和分数天数表示的实数值。示例:
|
TotalHours(Arg1) |
返回 TimeSpan 对应的小时数,以整数小时数和分数小时数表示的实数值。示例:
|
TotalMilliseconds(Arg1) |
返回 TimeSpan 对应的毫秒数,以整数毫秒数和分数毫秒数表示的实数值。示例:
|
TotalMinutes(Arg1) |
返回 TimeSpan 对应的分钟数,以整数分钟数和分数分钟数表示的实数值。示例:
|
TotalSeconds() |
返回 TimeSpan 对应的秒数,以整数秒数和分数秒数表示的实数值。示例:
|
Week(Arg1) |
从 Date 或 DateTime 列中提取周,以介于 1 和 54 之间的整数表示,其中年中的第一周取决于区域设置。另请参见 ISOWeek。示例:
|
Year(Arg1) |
从 Date 或 DateTime 列中提取年。结果为 Integer 类型。另请参见 ISOYear。示例:
|
YearAndWeek(Arg1) |
从 Date 或 DateTime 列中提取年和周。返回 Integer (年 * 100 + 周数)。例如,对于日期 2005-10-13,将返回 200541。计算取决于区域设置,并且在跨越年份边界时可能会产生不需要的结果。另请参见 ISOYear 、ISOWeek 和 BinByDateTime。示例:
有关详细信息,请参见时间层级的其他操作。 |