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

Temporal.PlainYearMonth.prototype.monthプロパティは、Temporal.PlainYearMonthオブジェクトが表現する「月」の値を保持するプロパティです。このプロパティは、JavaScriptにおける次世代の日付と時刻を扱うためのTemporal APIの一部として提供されています。Temporal APIは、タイムゾーンやうるう秒といった複雑さを厳密に扱い、不変性を持つ日付オブジェクトを提供する目的で設計されています。

特にTemporal.PlainYearMonthオブジェクトは、タイムゾーン情報や具体的な「日」を持たず、年と月のみで構成される日付の概念を表します。このmonthプロパティは、PlainYearMonthのインスタンスに設定された月の値を読み取るために使用されます。このプロパティが返す値は、グレゴリオ暦に基づいた1（1月）から12（12月）までの範囲の整数値であり、常に読み取り専用です。

システム開発において、特定の月のデータを集計したり、月単位で処理を行う必要がある場面で、Temporal.PlainYearMonthオブジェクトから正確な月情報を取得するためにこのプロパティが不可欠です。例えば、myYearMonth.monthのようにアクセスすることで、インスタンスがどの月を表しているかを確認し、その情報に基づいてプログラムのロジックを分岐させることができます。このプロパティを利用することで、日付に関する堅牢で予測可能な処理を実装できます。

Copy
1const plainYearMonth = new Temporal.PlainYearMonth(2023, 10);
2const monthNumber = plainYearMonth.month;

引数なし

引数はありません

Number

Temporal.PlainYearMonth.prototype.month は、その年月の「月」を表す数値を返します。この数値は 1 から 12 の範囲で、1 が 1月、12 が 12月 を示します。