【JavaScript ECMAScript】Temporal::Temporal.PlainMonthDay.prototype.toLocaleStringインスタンスメソッドの使い方

Temporal.PlainMonthDay.prototype.toLocaleString()メソッドは、Temporal.PlainMonthDayオブジェクトの月と日を、指定された言語と地域の形式で表す文字列に変換するメソッドです。Temporal.PlainMonthDayは、特定の年を持たず、月と日のみを表す日付オブジェクトであり、このメソッドはそのオブジェクトの値を人間が読みやすい形式に整形する役割を担います。

このメソッドを使用すると、アプリケーションの利用者が使い慣れた言語や地域の表記規則に従って、月と日を表示できます。例えば、日本のロケールでは「1月15日」のように、アメリカ英語のロケールでは「1/15」または「January 15」のように出力するといった柔軟な対応が可能です。

メソッドの第一引数には、日付文字列のフォーマットに使用するロケール（言語と地域）を示す文字列、またはその配列を指定します。省略された場合は、実行環境のデフォルトロケールが使用されます。第二引数には、表示オプションを定義するオブジェクトを指定できます。このオプションオブジェクトを使用することで、月の表示スタイル（例: 数字、短い略語、完全な名前）や日の表示スタイルなどを細かく制御することができます。

戻り値は、指定されたロケールとオプションに基づいて整形された、月と日を表す文字列です。Temporal.PlainMonthDayオブジェクトが年情報を持たないため、このメソッドによって生成される文字列にも年は含まれません。国際化されたシステム開発において、ユーザーエクスペリエンスを向上させるための重要な機能の一つです。

Copy
1const plainMonthDay = new Temporal.PlainMonthDay(12, 25);
2const formattedString = plainMonthDay.toLocaleString();

locales, options

• locales: string | string[] | undefined: 書式設定に使用するロケールを指定します。省略された場合は、実行環境のデフォルトロケールが使用されます。
• options: Intl.DateTimeFormatOptions | undefined: 書式設定のカスタマイズに使用するオプションを指定します。

string

このメソッドは、Temporal.PlainMonthDayオブジェクトを、実行環境の現在のロケールに基づいて、人間が読みやすい文字列形式に変換したものを返します。