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

Temporal.ZonedDateTime.prototype.monthプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する日付、時刻、およびタイムゾーンに関する情報から、その月の数値を読み取るためのプロパティです。

Temporal.ZonedDateTimeは、特定のタイムゾーンにおける厳密な日付と時刻を表現するためのJavaScriptのオブジェクトであり、うるう秒を含む複雑な時間概念も適切に扱います。このmonthプロパティを使用することで、Temporal.ZonedDateTimeインスタンスに格納されている日付の中から、1から12までの範囲で表されるISO 8601暦に基づく月を数値として取得できます。例えば、2023年10月15日を表すTemporal.ZonedDateTimeオブジェクトに対してこのプロパティにアクセスすると、「10」という数値が返されます。このプロパティは値を読み取る専用であり、月の値を直接変更することはできません。

システムエンジニアとして日付や時刻を扱う際、特定の期間でデータを集計したり、月ごとのレポートを作成したりする場面は多くあります。Temporal.ZonedDateTime.prototype.monthプロパティは、このようなケースで、タイムゾーンを考慮した正確な日付情報から直感的に月を取得できるため、アプリケーション開発において非常に有用です。これにより、月を基準としたデータ処理をより容易かつ正確に行うことが可能になります。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-03-15T10:00:00-08:00[America/Los_Angeles]');
2const monthNumber = zonedDateTime.month;

引数なし

引数はありません

Number

このプロパティは、Temporal.ZonedDateTimeオブジェクトが表す日付の月を、1から12の数値で返します。