Power Apps の WeekNum 関数と ISOWeekNum 関数

指定した日付に対応する週番号を返します。

内容

WeekNum 関数と ISOWeekNum 関数を使用して日付の週番号を決定します。

これらの関数は、年の最初の週 (第 1 週) を決定する方法が異なります。

• WeekNum は、1 月 1 日を含む週をその年の最初の週として使用します。 この関数の結果は、1 から 54 の範囲になります。

• ISOWeekNum はその年の第一木曜日を含む週をその年の最初の週として使用します。 これは、週番号に対して ISO 8601 の日付と時刻の標準定義 に従っています。 この関数の結果は、1 から 53 の範囲になります。 日付が前年の最後の週に属している可能性があるため、1 月の最初の日に 52 または 53 が返される可能性があります。

週を開始する日を指定するには、2 番目のパラメーターに 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 をサポートします。

ここに挙げた関数に数値を 1 つだけ渡した場合には、戻り値が 1 つだけ返されます。 複数の数値を含んだ単一列テーブル を渡すと、戻り値は複数の結果を含んだ単一列テーブルとなり、引数のテーブル内のレコードごとに 1 つの結果が返されます。 複数列テーブルがある場合は、テーブルの使用 に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。

構文

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

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。