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

Temporal.ZonedDateTime.prototype.dayOfYearプロパティは、ECMAScriptのTemporal APIに属する、Temporal.ZonedDateTimeオブジェクトのインスタンスが保持する日付が、その年の何日目にあたるかを示す数値を読み取るためのアクセサープロパティです。

このプロパティは読み取り専用であり、1から始まるその年の日（day-of-year）を表す整数値を返します。例えば、1月1日は1、1月2日は2、そして2月1日（うるう年でない場合）は32といった具体的な数値が得られます。うるう年には2月29日が存在するため、最大値は366となりますが、このプロパティはそのような暦の特性を自動的に考慮して正確な値を算出します。

Temporal.ZonedDateTimeオブジェクトはタイムゾーンの情報を内包しているため、dayOfYearプロパティは指定されたタイムゾーンの規則に従って計算された「年の日」を提供します。これにより、夏時間（DST）の開始や終了、またはタイムゾーンの境界を越えるような日付であっても、そのタイムゾーンにおける実際のカレンダー上の日の位置を正確に把握することが可能です。

システムエンジニアが年間を通じたイベントのスケジュール管理や、特定の日付が年間でどの位置にあるかを基にしたデータの集計を行う際に、このdayOfYearプロパティは非常に有用です。例えば、特定の日にちがその年の何週目にあたるかを計算する際の補助情報として利用したり、年度末までの残りの日数を計算したりする場面で活用できます。このプロパティは、日付と時刻の処理をより正確かつ直感的に行うための重要な要素の一つです。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from("2023-03-15T10:00:00+09:00[Asia/Tokyo]");
2const dayOfYear = zonedDateTime.dayOfYear; // 74

引数なし

引数はありません

number

このプロパティは、DateTimeオブジェクトが表す日付の、その年の1月1日から数えて何日目にあたるかを数値で返します。