| 功能 | 適用對象 |
|---|---|
| ISOWeekNum |
畫布應用程式 Dataverse 公式欄 模型導向應用程式 Power Pages |
| WeekNum |
畫布應用程式 Copilot Studio 桌面流程 Dataverse 公式欄 模型導向應用程式 Power Platform CLI Dataverse 函數 Power Pages |
傳回特定日期的週數。
Description
使用 and WeekNumISOWeekNum 函數來決定日期的週數。
這些函式在確定一年中第一週 (第 1 週) 的方式有所不同：
WeekNum 使用包含 1 月 1 日的一週作為一年的第一週。 此函式的結果範圍從 1 到 54。
ISOWeekNum 使用包含一年中第一個星期四的一週作為一年的第一週。 這遵循 ISO 8601 日期和時間標準定義來進行每週編號。 此函式的結果範圍從 1 到 53。 1 月的第一天可能會傳回 52 或 53，因為這些日期可能屬於上一年的最後一週。
使用第二個參數 來 WeekNum 指定哪一天開始一週。 您可以提供 Excel 程式碼編號，也可以使用 StartOfWeek 列舉：
| Excel 程式碼 | StartOfWeek 列舉 | Description |
|---|---|---|
| 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（日期時間 [， StartOfWeek ]）
- DateTime - 必需。 要運作的日期/時間值。
- StartOfWeek - 可選。 Excel 程式碼或 StartOfWeek 枚舉可決定一週的從哪一天開始。
ISOWeekNum（日期時間）
- DateTime - 必需。 要運作的日期/時間值。 一週從星期一開始。
範例
2021 年的第一個和最後一個行事曆週
| 日期 | WeekNum（ 日期 ） | ISOWeekNum（ 日期 ） | WeekNum（ 日期， 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 |