【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.weekOfYearインスタンスアクセサプロパティの使い方
Temporal.PlainDateTime.prototype.weekOfYearインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainDateTime.prototype.weekOfYearプロパティは、Temporal.PlainDateTimeオブジェクトが表す特定の日付が、その年の何番目の週に当たるかを示す整数値を保持するプロパティです。このプロパティは、タイムゾーンに依存しない純粋な日付と時刻を表すTemporal.PlainDateTimeインスタンスに付随しています。週番号は、国際的な規格であるISO 8601に基づいて計算されます。ISO 8601では、その年の最初の木曜日を含む週がその年の第1週と定義されており、週の始まりは月曜日、終わりは日曜日とされています。
このweekOfYearプロパティを利用することで、開発者は特定の日付が年間でどの週に属するのかを、複雑な計算ロジックを実装することなく簡単に取得できます。例えば、週ごとのデータを集計するレポートや、週単位でのイベントスケジューリングなど、日付データを週単位で処理する必要がある場面で非常に役立ちます。このプロパティは読み取り専用であり、日付オブジェクトから週の情報を取得するための簡潔かつ正確な手段を提供します。
構文(syntax)
1const plainDateTime = new Temporal.PlainDateTime(2023, 10, 26); 2const weekNumber = plainDateTime.weekOfYear;
引数(parameters)
引数なし
引数はありません
戻り値(return)
Number
このプロパティは、Temporal.PlainDateTimeオブジェクトが表す日付の、その年の何週目にあたるかを数値で返します。