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 |