WeekNum 関数と ISOWeekNum 関数
適用対象:
キャンバス アプリ モデル駆動型アプリ Power Pages Dataverse 数式列
指定した日付に対応する週番号を返します。
Description
WeekNum 関数と ISOWeekNum 関数を使用して日付の週番号を決定します。
これらの関数は、年の最初の週 (第 1 週) を決定する方法が異なります。
WeekNum は、1月1日を含む週をその年の最初の週として使用します。 この関数の結果は、1 から 54 の範囲になります。
ISOWeekNum は、年の最初の木曜日を含む週をその年の最初の週として使用します。 これは、週番号に対して ISO 8601 の日付と時刻の標準定義 に従っています。 この関数の結果は、1 から 53 の範囲になります。 日付が前年の最後の週に属している可能性があるため、1 月の最初の日に 52 または 53 が返される可能性があります。
週を開始する日を指定するには、2 番目のパラメーターに WeekNum を使います。 Excel コード番号を指定するか、StartOfWeek 列挙を使用できます。
| Excel コード | StartOfWeek リスト | 内容 |
|---|---|---|
| 1, 17 | 週の始まり.日曜日 | 週は日曜日に始まります。 既定。 |
| 2, 11 | 週の始まり月曜日 | 週は月曜日から始まります。 |
| 12 | 週の始まり火曜日 | 週は火曜日から始まります。 |
| 13 | 週の始まり水曜日 | 週は水曜日から始まります。 |
| 14 | 週の始まり木曜日 | 週は木曜日から始まります。 |
| 15 | 週の始まり。金曜日 | 週は金曜日から始まります。 |
| 16 | 週の始まり.土曜日 | 週は土曜日から始まります。 |
ISOWeekNum は常に月曜日を週の始まりとして使用します。 Excel では、WeekNum 関数は加算コード 21 をサポートしますが、ここではサポートされていないため代わりに ISOWeekNum をサポートします。
ここに挙げた関数に数値を 1 つだけ渡した場合には、戻り値が 1 つだけ返されます。 複数の数値を含んだ単一列テーブル を渡すと、戻り値は複数の結果を含んだ単一列テーブルとなり、引数のテーブル内のレコードごとに 1 つの結果が返されます。 複数列テーブルがある場合は、テーブルの使用 に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。
構文
週番号(日時 [, 週の開始 ])
- 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 |