【JavaScript ECMAScript】Temporal::Temporal.PlainDate.prototype.monthCodeインスタンスアクセサプロパティの使い方
Temporal.PlainDate.prototype.monthCodeインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainDate.prototype.monthCodeプロパティは、Temporal.PlainDateオブジェクトが持つ、日付の「月コード」を保持する読み取り専用のプロパティです。このプロパティは、特定の日付が属する月を、そのカレンダーシステム（暦）の規則に基づいて一意に識別するための文字列形式で提供します。一般的な月を表す数値（例えば1月から12まで）とは異なり、monthCodeはカレンダーの種類や地域の慣習に依存する複雑な月の表現（例えば、特定の暦における閏月など）にも対応できるよう設計されています。
具体的には、グレゴリオ暦のような標準的な暦の場合、1月であれば「M01」、2月であれば「M02」といった形式の文字列を返します。この形式は、月を常に二桁で表現し、先頭に「M」を付けることで、他の数値情報との混同を防ぎ、月のコードであることを明確にします。
このmonthCodeプロパティは、特に多様なカレンダーシステムを扱うアプリケーションを開発する際に非常に有用です。例えば、ユーザーの選択する暦に基づいて日付を表示したり、異なる暦の日付を正確に比較・並べ替えたりする際に、カレンダー固有の月の情報を安全かつ一貫した方法で取得できます。システムエンジニアを目指す方にとって、国際的な日付処理を正確に行う上で理解しておくべき重要な概念です。
公式リファレンス: Temporal.PlainDate.prototype.monthCode
構文(syntax)
1const plainDateInstance = Temporal.PlainDate.from({ year: 2023, month: 10, day: 26 }); 2const monthCodeString = plainDateInstance.monthCode;
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
このメソッドは、日付オブジェクトの月を表す文字列を返します。例えば、1月であれば "M01" のような形式で返されます。