Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

Temporal.PlainMonthDay.prototype.calendarIdインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Temporal.PlainMonthDay.prototype.calendarIdプロパティは、年情報を含まない月と日を表すTemporal.PlainMonthDayオブジェクトが、どの暦体系(カレンダーシステム)に基づいているかを示す文字列を保持するプロパティです。

このプロパティは、作成されたPlainMonthDayオブジェクトが「iso8601」(一般的なグレゴリオ暦の国際標準)や「japanese」(和暦)といった、利用されているカレンダーシステムの識別子を提供します。これにより、同じ月日であっても異なる暦体系に属する可能性がある場合に、その由来を明確に区別することが可能になります。

例えば、複数のカレンダーシステムを扱うアプリケーションにおいて、特定の月日データがどのカレンダーの文脈で解釈されるべきかを識別する際に非常に重要です。このプロパティは読み取り専用であり、PlainMonthDayオブジェクトが一度作成されるとその値は変更できません。

システムエンジニアを目指す方にとって、国際的なアプリケーション開発や、多様な文化圏に対応するシステムを構築する際、日付や時刻の正確な扱いを保証するために、この暦体系の識別子を理解し活用することは不可欠です。

構文(syntax)

1const plainMonthDayObject = new Temporal.PlainMonthDay(1, 15, { calendar: "iso8601" });
2const calendarIdentifier = plainMonthDayObject.calendarId;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

この calendarId プロパティは、Temporal.PlainMonthDay オブジェクトが参照しているカレンダーの識別子を文字列で返します。

関連コンテンツ

関連プログラミング言語