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

Temporal.PlainDate.prototype.dayOfYearプロパティは、Temporal.PlainDateオブジェクトが表す日付が、その年の最初の日（1月1日）から数えて何日目にあたるかを示す数値を保持するプロパティです。このプロパティを使用すると、特定の日付の年間通算日数を簡単に取得できます。例えば、1月1日の場合であれば値は1を、2月1日の場合であれば通常の年では32を返します。常に正の整数が返されます。

このプロパティは、JavaScriptにおける日付と時刻を扱う新しい標準であるTemporal APIの一部です。Temporal.PlainDateオブジェクトは、タイムゾーンやUTCオフセットといった時間帯に関する情報を含まず、純粋に年、月、日のみを表現します。そのため、dayOfYearプロパティによって返される値は、タイムゾーンに依存せず一意に決まります。

Temporal.PlainDateのインスタンスに対してのみアクセス可能で、plainDateInstance.dayOfYearのように直接参照することで、その日付の年間通算日数を取得できます。閏年の場合でも、2月29日の日数が正しく考慮されて計算されます。システム開発において、特定の日付がその年の中でどの位置にあるかを知りたい場合や、年間を通じたイベント管理、統計処理などで日付の通算日が必要な場合に非常に役立ちます。

Copy
1const plainDate = new Temporal.PlainDate(2024, 3, 15);
2const dayOfYear = plainDate.dayOfYear;

引数なし

引数はありません

Number

その年の1月1日からの経過日数（1〜366）を表す数値です。