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

Temporal.ZonedDateTime.prototype.weekOfYearプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する特定の日時が、その年の何番目の週にあたるかを示す週番号を保持するプロパティです。このプロパティは、JavaScriptの新しい日付と時刻APIであるTemporal APIの一部であり、タイムゾーンとUTCからのオフセット情報を持つ日時データ（ZonedDateTimeインスタンス）に対して利用できます。

weekOfYearプロパティは、ISO 8601国際規格に基づいて週番号を計算します。ISO 8601規格では、その年の最初の木曜日を含む週がその年の第1週（週番号1）と定義されています。これにより、異なる環境間でも一貫した週番号の解釈が保証されます。

このプロパティを参照すると、1から53までの整数値が返されます。この値は、対象となるZonedDateTimeインスタンスが示す日時が、その年の始まりから数えて何番目の週に位置するかを明確に示します。例えば、ある日付が1月上旬の場合、通常は週番号1または2が返されます。

システム開発において、このweekOfYearプロパティは、週単位でのデータ集計、スケジューリング、レポート作成など、正確な週番号が必要とされる様々な場面で非常に有用です。特に、国際的なアプリケーション開発において、週の定義の一貫性を保つ上で重要な役割を果たします。

Copy
1const zonedDateTimeInstance = new Temporal.ZonedDateTime(
2  Temporal.Instant.from('2024-07-20T10:00:00Z'),
3  'America/New_York'
4);
5
6const weekOfYear = zonedDateTimeInstance.weekOfYear;

引数なし

引数はありません

number

Temporal.ZonedDateTime.prototype.weekOfYear は、この日付がその年の何週目にあたるかを示す数値を返します。週の開始日は、カレンダーの週の定義に依存します。