WeekNum 関数と ISOWeekNum 関数
適用先:
キャンバス アプリ モデル駆動型アプリ 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 | 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 |