【JavaScript ECMAScript】Temporal::Temporal.PlainDate.prototype.weekOfYearインスタンスアクセサプロパティの使い方

Temporal.PlainDate.prototype.weekOfYearプロパティは、Temporal.PlainDateオブジェクトが保持する日付が、その年の何週目にあたるかを示す数値を保持するプロパティです。このプロパティは、JavaScriptの新しい日付時刻APIであるTemporal APIの一部として提供されており、日付データをより堅牢かつ直感的に扱えるように設計されています。

Temporal.PlainDateオブジェクトは、タイムゾーンやUTCオフセット情報を持たない「日付のみ」を表すオブジェクトです。このweekOfYearプロパティは、特定のTemporal.PlainDateインスタンスに対して利用可能なアクセサープロパティであり、インスタンスから直接呼び出すことで、その日付が属する週の年間番号を取得できます。

返される値は、1から52または53までの整数で、日付がその年の何番目の週に位置するかを示します。週の定義は、ISO 8601などの国際標準に準拠しており、通常、その年の最初の木曜日を含む週が「第1週」と見なされます。このプロパティを利用することで、例えば週ごとのレポート作成やスケジュール管理など、日付の週単位での処理が容易になります。システム開発において、日付に関連するロジックを正確かつ効率的に実装するために非常に役立つ機能です。

Copy
1const plainDate = new Temporal.PlainDate(2023, 1, 8);
2const weekNumber = plainDate.weekOfYear;
3console.log(weekNumber);

引数なし

引数はありません

Number

Temporal.PlainDate.prototype.weekOfYearは、その日付が何週目であるかを数値で返します。