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

Temporal.PlainMonthDay.prototype.monthCodeプロパティは、JavaScriptの新しい日付時刻APIであるTemporal APIにおいて、年情報を含まない月日を表すTemporal.PlainMonthDayオブジェクトが持つ月の情報を、標準化された文字列形式で保持するプロパティです。このプロパティは、そのPlainMonthDayインスタンスが示す月を識別するためのコードを提供します。

具体的には、月の番号をISO 8601拡張フォーマットに準拠した「M」と2桁のゼロパディングされた月番号で構成される文字列として返します。例えば、1月は「M01」、2月は「M02」、そして12月は「M12」といった形式です。この形式は、単なる数値の月（例: 1, 2）とは異なり、どの暦体系のどの月であるかをより明確に示し、国際的なデータ交換や表示において曖昧さを排除するのに役立ちます。

Temporal.PlainMonthDayオブジェクトは、特定の年に関係なく、毎年繰り返される特定の月日（例えば、毎年の誕生日や記念日など）を扱う際に使用されます。monthCodeプロパティを利用することで、その月日が何月であるかを、数値ではなく、視覚的にも一貫性があり、プログラム上でも比較しやすい統一された形式で取得できます。これにより、システムの内部処理で月の識別子として利用したり、ユーザーインターフェースで月に応じた表示を制御したりするなど、月の情報を厳密かつ効率的に扱う必要がある場面で非常に有用です。初心者の方も、このプロパティを通じて、国際標準に準拠した月の表現方法を理解し、より堅牢な日付処理を実装する基盤とすることができます。

Copy
1const plainMonthDay = new Temporal.PlainMonthDay(10, 26);
2const monthCodeValue = plainMonthDay.monthCode;

引数なし

引数はありません

string

このプロパティは、PlainMonthDay オブジェクトの月を表す文字列を返します。例えば、1月であれば "M01" のような形式です。