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

Temporal.PlainDate.prototype.eraプロパティは、Temporal.PlainDateオブジェクトが内部的に保持する「紀元（era）」または「時代」の情報を文字列として取得するためのプロパティです。Temporal.PlainDateは、タイムゾーンに依存しない日付情報（年、月、日）を扱うためのオブジェクトであり、このプロパティはその日付が属する特定の紀元や時代を示す文字列を提供します。

例えば、多くのプログラミング環境で標準的に使用されるグレゴリオ暦の場合、このプロパティは「AD」（西暦）のような値を返します。一方、日本で使われる和暦のような特定の暦法を用いた日付オブジェクトにおいては、「令和」や「平成」といった元号の情報を取得できます。このプロパティは読み取り専用であり、その値を直接設定することはできません。

このプロパティの主な用途は、日付が属する時代区分をプログラム上で確認したり、その情報をユーザーインターフェースに表示したりすることです。特に、国際化されたアプリケーションや、異なる文化圏の暦法を扱うシステムを開発する際に、日付の表現を正確かつ適切に行うために重要な役割を果たします。システムエンジニアを目指す初心者の方にとって、日付や時刻の厳密な扱いは必須のスキルであり、eraプロパティはその理解と実践に役立つでしょう。

Copy
1const plainDate = new Temporal.PlainDate(2023, 1, 1);
2plainDate.era;

引数なし

引数はありません

String

Temporal.PlainDate.prototype.era は、日付の紀元を表す文字列を返します。例えば、西暦の元号（"AD" や "BC" など）が該当します。