WeekNum 和 ISOWeekNum 函数
适用于：
画布应用模型驱动应用 Dataverse 公式列
返回特定日期的周编号。
Description
使用 WeekNum 和 ISOWeekNum 函数可以确定日期的周编号。
这些函数在确定一年中的第一周（第 1 周）的方式上有所不同：
WeekNum 使用包含 1 月 1 日的那一周作为一年的第一周。 此函数的结果范围为 1 到 54。
ISOWeekNum 使用包含一年中第一个星期四的那一周作为一年中的第一周。 这将遵循 ISO 8601 日期和时间标准定义进行周编号。 此函数的结果范围为 1 到 53。 1 月的第一天可能会返回 52 或 53，因为这些日期可能属于上一年的最后一周。
使用 WeekNum 的第二个参数指定周的开始日。 您可以提供 Excel 代码编号或使用 StartOfWeek 枚举：
| Excel 代码 | StartOfWeek 枚举 | 描述 |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | 周从星期日开始。 默认。 |
| 2, 11 | StartOfWeek.Monday | 周从星期一开始。 |
| 12 | StartOfWeek.Tuesday | 周从星期二开始。 |
| 13 | StartOfWeek.Wednesday | 周从星期三开始。 |
| 14 | StartOfWeek.Thursday | 周从星期四开始。 |
| 15 | StartOfWeek.Friday | 周从星期五开始。 |
| 16 | StartOfWeek.Saturday | 周从星期六开始。 |
ISOWeekNum 始终使用星期一作为周开始日。 在 Excel 中，WeekNum 函数支持加法代码 21，这里不支持； 请改用 ISOWeekNum。
如果将单个数值传递给这些函数，则返回值为单个结果。 如果您传递包含数字的单列表，则返回单列表结果值，参数表中每条记录都对应一个结果。 如果您有多列表，可以将其调整为单列表，如使用表中所述。
语法
WeekNum(DateTime [, StartOfWeek ])
- DateTime - 必需。 要进行运算的日期/时间值。
- StartOfWeek - 可选。 Excel 代码或 StartOfWeek 枚举，用于确定周开始日。
ISOWeekNum(DateTime)
- DateTime - 必需。 要进行运算的日期/时间值。 周总是从星期一开始。
示例
2021 年的第一个日历周和最后一个日历周
| 日期 | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| 2021年1月 1 日，星期五 | 1 | 53 | 1 |
| 2021年1月 2 日，星期六 | 1 | 53 | 1 |
| 2021年1月 3 日，星期日 | 2 | 53 | 1 |
| 2021年1月 4 日，星期一 | 2 | 1 | 1 |
| 2021年1月 5 日，星期二 | 2 | 1 | 1 |
| 2021年1月 6 日，星期三 | 2 | 1 | 2 |
| 2021年1月 7 日，星期四 | 2 | 1 | 2 |
| 2021年12月 25 日，星期六 | 52 | 51 | 52 |
| 2021年12月 26 日，星期天 | 53 | 51 | 52 |
| 2021年12月 27 日，星期一 | 53 | 52 | 52 |
| 2021年12月 28 日，星期二 | 53 | 52 | 52 |
| 2021年12月 29 日，星期三 | 53 | 52 | 53 |
| 2021 年12月30 日，星期四 | 53 | 52 | 53 |
| 2021年12月 31 日，星期五 | 53 | 52 | 53 |