日期和时间函数
下面的列表显示了可在表达式中使用的日期和时间函数。
| 函数 | 说明 |
|---|---|
| DateAdd(Arg1, Arg2, Arg3) | 向 Date、Time 或 DateTime 添加间隔。该方法可添加 TimeSpan 或表示指定日期或时间部分（例如，天数）的 Integer。 如果要添加 TimeSpan，则需要两个参数：DateTime 列和 TimeSpan 列。 如果要向日期或时间部分添加一个整数值，则使用三个参数：Arg1 是一个字符串，说明要添加的部分。Arg2 是一个数字，其中包含要添加的部分数。Arg3 是 Date 列、Time 列或 DateTime 列。 Arg1 的有效参数包括： “year”或“yy”- 年。 “quarter”或“qq”- 季度。 “month”或“mm”- 月。 “day”或“dd”- 日。 “week”或“wk”- 周。 “hour”或“hh”- 时。 “minute”或“mi”- 分。 “second”或“ss”- 秒。 “millisecond”或“ms”- 毫秒。 示例： DateAdd([Date Column], [TimeSpan Column]) DateAdd('year', 2, [Date Column]) DateAdd('month', 1, [Date Column]) |
| DateDiff(Arg1, Arg2, Arg3) | 计算两个 Date、Time 或 DateTime 列之间的差。结果以 TimeSpan 或表示指定时间部分（例如天数）的实数值显示。 如果使用了两个参数（开始日期列和停止日期列），则结果将是显示总体差的 TimeSpan 值。 如果使用了三个参数，则第一个参数应是要比较的部分。第二个参数是开始日期列，第三个参数是停止日期列。运算的结果为实数值。 Arg1 的有效参数包括： “year”或“yy”- 年。 “quarter”或“qq”- 季度。 “month”或“mm”- 月。 “day”或“dd”- 日。 “week”或“wk”- 周。 “hour”或“hh”- 时。 “minute”或“mi”- 分。 “second”或“ss”- 秒。 “millisecond”或“ms”- 毫秒。 示例： DateDiff([Order Date], [Delivery Date]) DateDiff('day', [Order Date], [Delivery Date]) |
| DatePart(Arg1, Arg2) | 返回 Date、Time 或 DateTime 的指定部分。Arg1 是说明要获取的日期部分的字符串，Arg2 是 Date、Time 或 DateTime 列。 Arg1 的有效参数包括： “year”或“yy”- 年。 “quarter”或“qq”- 季度。 “month”或“mm”- 月。 “day of year”或“dy”- 年中第几日。 “day”或“dd”- 日。 “year and week”或“yywk”- 年和周。 “week”或“wk”- 周。 “day of week”或“dw”- 工作日。 “hour”或“hh”- 时。 “minute”或“mi”- 分。 “second”或“ss”- 秒。 “millisecond”或“ms”- 毫秒。 示例： DatePart('year', [Date Column]) |
| DateTimeNow() | 返回当前系统时间。 示例： DateTimeNow() |
| Day(Arg1) | 从 Date 或 DateTime 列中提取月中第几日。结果是介于 1 和 31 之间的整数。 示例： Day([Date Column]) |
| DayOfMonth(Arg1) | 从 Date 或 DateTime 列中提取月中第几日。结果是介于 1 和 31 之间的整数。 示例： DayOfMonth([Date Column]) |
| DayOfWeek(Arg1) | 从 Date 或 DateTime 列中提取周中第几日。新列的基础数据是一个介于 0（星期日）到 6（星期六）之间的整数，但区域设置决定周的开始以及格式化输出。 示例： DayOfWeek([Date Column]) |
| DayOfYear(Arg1) | 从 Date 或 DateTime 列中提取年中第几日。返回介于 1 和 366 之间的整数。 示例： DayOfYear([Date Column]) |
| Days(Arg1) | 返回 TimeSpan 对应的天数，介于 -10675199 和 10675199 之间的 Integer 值； 或者，如果参数为 Integer 值，则创建一个 TimeSpan 列，其中输入为天数。 示例： Days([TimeSpan Column]) Days(3) |
| FiscalMonth(Arg1, Arg2) | 返回某日期所在的财政月。 第一个参数是 Date 列。第二个参数（可选）是要切换的月数。 如果未指定第二个参数，则会使用文档属性 FiscalYearOffset 的值。区域设置决定格式化输出。 在层级中使用时，FiscalMonth 方法会记录月份的排序顺序，以便以正确顺序显示图表项目。例如，如果财年在一月结束，那么如下所示财年会在二月开始，而非一月： 图像中的层级可通过以下表达式构建： <FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)> 示例： FiscalMonth([Date Column], 1) FiscalMonth([Date Column]) |
| FiscalQuarter (Arg1, Arg2) | 根据月份（Arg1）中指定的切换返回日期所在（Arg2）的财政季度。 第二个参数为可选项。如果未指定第二个参数，则会使用文档属性 FiscalYearOffset 的值。 示例： FiscalQuarter([Date Column], 1) FiscalQuarter([Date Column]) |
| FiscalYear (Arg1, Arg2) | 根据月份（Arg1）中指定的切换返回日期所在（Arg2）的财政年。 第二个参数为可选项。如果未指定第二个参数，则会使用文档属性 FiscalYearOffset 的值。 示例： FiscalYear([Date Column], 1) FiscalYear([Date Column]) |
| Hour(Arg1) | 从 DateTime 或 Time 列中提取小时。返回介于 0 和 23 之间的整数。 示例： Hour([Time Column]) |
| Hours(Arg1) |
返回 TimeSpan 对应的小时数，介于 0 和 23 之间的 Integer 值； 或者，如果参数为 Integer 值，则创建一个 TimeSpan 列，其中输入为小时数。 示例： Hours([TimeSpan Column]) Hours(10) |
| Millisecond(Arg1) |
从 DateTime 或 Time 列中提取毫秒。返回介于 0 和 999 之间的整数。 示例： Millisecond([Time Column]) |
| Milliseconds(Arg1) |
返回 TimeSpan 对应的毫秒数，介于 0.0 和 999.0 之间的 Real 值； 或者，如果参数为 Real 值，则创建一个 TimeSpan 列，其中输入为毫秒数。 示例： Milliseconds([TimeSpan Column]) Milliseconds(123.45) |
| Minute(Arg1) | 从 DateTime 或 Time 列中提取分钟。返回介于 0 和 59 之间的整数。 示例： Minute([Time Column]) |
| Minutes(Arg1) |
返回 TimeSpan 对应的分钟数，介于 0 和 59 之间的 Integer 值； 或者，如果参数为 Integer 值，则创建一个 TimeSpan 列，其中输入为分钟数。 示例： Minutes([TimeSpan Column]) Minutes(50) |
| Month(Arg1) | 从 Date 或 DateTime 列中提取月份。新列的基础数据为介于 1 和 12 之间的整数，但区域设置会确定格式化输出。 示例： Month([Date Column]) |
| Quarter(Arg1) | 从 Date 或 DateTime 列中提取季度。新列的基础数据为介于 1 和 4 之间的整数，但区域设置会确定格式化输出。 示例： Quarter([Date Column]) |
| Second(Arg1) | 从 DateTime 或 Time 列中提取秒。返回介于 0 和 59 之间的整数。 示例： Second([Time Column]) |
| Seconds(Arg1) | 返回 TimeSpan 对应的秒数，介于 0 和 59 之间的 Integer 值； 或者，如果参数为 Integer 值，则创建一个 TimeSpan 列，其中输入为秒数。 示例： Seconds([TimeSpan Column]) Seconds(10) |
| Today() | 返回当前日期。 示例： Today() |
| TotalDays(Arg1) | 返回 TimeSpan 对应的天数，以整数天数和分数天数表示的实数值。 示例： TotalDays([TimeSpan Column]) |
| TotalHours(Arg1) | 返回 TimeSpan 对应的小时数，以整数小时数和分数小时数表示的实数值。 示例： TotalHours([TimeSpan Column]) |
| TotalMilliseconds(Arg1) | 返回 TimeSpan 对应的毫秒数，以整数毫秒数和分数毫秒数表示的实数值。 示例： TotalMilliseconds([TimeSpan Column]) |
| TotalMinutes(Arg1) | 返回 TimeSpan 对应的分钟数，以整数分钟数和分数分钟数表示的实数值。 示例： TotalMinutes([TimeSpan Column]) |
| TotalSeconds() | 返回 TimeSpan 对应的秒数，以整数秒数和分数秒数表示的实数值。 示例： TotalSeconds([TimeSpan Column]) |
| Week(Arg1) | 从 Date 或 DateTime 列中提取周，以介于 1 和 54 之间的整数表示，其中年中的第一周取决于区域设置。 示例： Week([Date Column]) |
| Year(Arg1) | 从 Date 或 DateTime 列中提取年。结果为 Integer 类型。 示例： Year([Date Column]) |
| YearAndWeek(Arg1) | 从 Date 或 DateTime 列中提取年和周。返回 Integer（年 * 100 + 周数）。例如，对于日期 2005-10-13，将返回 200541。 示例： YearAndWeek([Date Column]) |
