WeekNum 和 ISOWeekNum 函式
適用於：
畫布應用 模型驅動應用 Power Pages 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.星期三 | 一週從星期三開始。 |
| 14 | StartOfWeek.Thursday | 一週從星期四開始。 |
| 15 | StartOfWeek.Friday 星期五 | 一週從星期五開始。 |
| 16 | StartOfWeek.Saturday（開始周.星期六） | 一週從星期日開始。 |
ISOWeekNum 始終使用星期一作為一周的開始。 在 Excel 中，WeekNum 函式支援加法程式碼 21，但在這裡不支援; 請改用 ISOWeekNum。
如果您對這些函式傳遞單一數字，則傳回值是單一結果。 如果您傳遞包含數字的單欄 資料表，則傳回值會以單欄資料表顯示結果，引數資料表中的每筆記錄都有一個結果。 如果您有多欄資料表，您可依照 使用資料表 所述，將該資料表改為單欄資料表。
語法
WeekNum（DateTime[，StartOfWeek ]）
- DateTime - 必需。 要運作的日期/時間值。
- StartOfWeek - 可選。 Excel 程式碼或 StartOfWeek 枚舉可決定一週的從哪一天開始。
ISOWeekNum（日期時間）
- 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 |