次の方法で共有

WeekNum 関数と ISOWeekNum 関数

機能 対象
ISOWeekNum Power Pages モデル駆動型アプリ Dataverse 数式列をするキャンバス アプリ
WeekNum Power Platform CLI Dataverse 関数 Power Pages モデル駆動型アプリ Dataverse 数式列、Copilot Studio デスクトップ フローキャンバス アプリ

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

Description

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

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

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

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

2 番目のパラメーターを使用して WeekNum 、週から始まる曜日を指定します。 Excel コード番号を指定するか、StartOfWeek 列挙を使用できます。

Excel コード StartOfWeek リスト Description
1、 17 週の始まり.日曜日 週は日曜日に始まります。 既定。
2、 11 週の始まり月曜日 週は月曜日から始まります。
12 週の始まり火曜日 週は火曜日から始まります。
13 週の始まり水曜日 週は水曜日から始まります。
14 週の始まり木曜日 週は木曜日から始まります。
15 週の始まり。金曜日 週は金曜日から始まります。
16 週の始まり.土曜日 週は土曜日から始まります。

ISOWeekNum 常に週の始まりとして月曜日を使用します。 Excel では、 WeekNum 関数は、ここでサポートされていない追加コード 21 をサポートしています。代わりに ISOWeekNum 使用してください。

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

構文

WeekNum(DateTime [, StartOfWeek ])

  • DateTime - 必須。 操作する日付/時刻値。
  • StartOfWeek - オプション。 週の開始日を決定する Excel コードまたは StartOfWeek 列挙。

ISOWeekNum(DateTime)

  • DateTime - 必須。 操作する日付/時刻値。 週は常に月曜日から始まります。

例

2021 年の暦上の最初の週と最後の週

日 WeekNum( 日付 ) ISOWeekNum( 日付 ) 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