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

Temporal.PlainDate.prototype.monthプロパティは、Temporal.PlainDateオブジェクトの「月」の情報を保持するプロパティです。このプロパティは、JavaScriptの新しい日付と時刻のAPIであるTemporalによって提供され、タイムゾーン情報や時刻を含まない純粋な日付のみを扱うPlainDateインスタンスに利用されます。

具体的には、Temporal.PlainDateのインスタンスが表す日付が何月であるかを、1から12までの数値で取得することができます。例えば、1月であれば1、12月であれば12という値が返されます。このmonthプロパティは読み取り専用のアクセサープロパティであり、一度作成されたPlainDateオブジェクトの月の値を安全に参照するために使用されます。直接このプロパティの値を変更することはできません。

システム開発において、特定の日付がどの月に属するかを判断したり、月ごとにデータを集計したりする処理は頻繁に登場します。Temporal.PlainDate.prototype.monthプロパティは、そのような日付関連の処理を、従来のDateオブジェクトよりも明確で予測可能な方法で実現するための基本的な構成要素の一つです。このAPIの導入により、開発者は日付処理における一般的な問題を避け、より堅牢なアプリケーションを構築できるようになります。このプロパティの理解は、Temporal APIを使った日付処理の基礎となります。

Copy
1const plainDate = new Temporal.PlainDate(2023, 10, 26);
2const monthNumber = plainDate.month;
3// monthNumber は 10 です

引数なし

引数はありません

number

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