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

Temporal.ZonedDateTime.prototype.dayプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する特定の日付と時刻情報の中から、その月の「日」を表す数値を取得するためのプロパティです。Temporal.ZonedDateTimeは、特定のタイムゾーンにおける日付と時刻を正確に表現するためのJavaScriptのオブジェクトであり、時間帯の概念を考慮した複雑な時間計算を可能にします。このdayプロパティにアクセスすることで、ZonedDateTimeインスタンスが示す日付が、その月の何日であるか（例えば、1日から31日の間の数値）を簡単に参照できます。これは、日付の特定の要素だけが必要な場合に非常に便利です。例えば、2023年10月26日を表すZonedDateTimeオブジェクトがあった場合、dayプロパティにアクセスすると26という数値が返されます。このプロパティは読み取り専用であり、ZonedDateTimeオブジェクトの「日」の値を直接変更することはできません。システムエンジニアを目指す方にとって、日付や時刻の扱いはシステムの根幹に関わることが多く、特にタイムゾーンを考慮した正確な日付操作は重要です。dayプロパティは、Temporal APIを用いた日付処理において、日付の構成要素を理解し、必要な情報を効率的に抽出するために役立ちます。このように、Temporal.ZonedDateTime.prototype.dayプロパティは、タイムゾーン付きの日付オブジェクトから「日」の部分を安全かつ簡潔に取得するための、非常に実用的な機能を提供します。

Copy
1const exampleZonedDateTime = Temporal.ZonedDateTime.from("2023-10-27T15:30:00+09:00[Asia/Tokyo]");
2const dayOfMonth = exampleZonedDateTime.day; // dayOfMonth の値は 27

引数なし

引数はありません

number

このプロパティは、Temporal.ZonedDateTime オブジェクトが表す日付の「日」を表す数値を返します。例えば、1月5日であれば5を返します。