【JavaScript ECMAScript】Intl::Intl.DateTimeFormat.supportedLocalesOf静的メソッドの使い方
Intl.DateTimeFormat.supportedLocalesOf()静的メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Intl.DateTimeFormat.supportedLocalesOf()メソッドは、JavaScriptの国際化API（Intlオブジェクト）の一部として、特定の日付および時刻のフォーマット機能（Intl.DateTimeFormat）が、与えられたロケールリストの中で実際にサポートしているロケールを判別し、そのリストを返すメソッドです。
このメソッドは、国際化対応（i18n）を行うアプリケーションにおいて、ユーザーが希望する言語や地域の設定（ロケール）に基づいて、システムが実際に日付や時刻の表示をサポートできるロケールを効率的に特定するために利用されます。例えば、ウェブアプリケーションがユーザーのブラウザ設定から複数のロケール候補（例: ["ja-JP", "en-US", "fr-FR"]）を受け取った際に、アプリケーションがそれらの中で実際に利用可能なロケールを正確に把握し、適切な日付時刻フォーマットを選択するために使用します。
このメソッドは、検証したいロケール識別子を文字列または文字列の配列として受け取る第一引数localesと、ロケール解決のアルゴリズムを指定するlocaleMatcherなどのオプションを含むオブジェクトを受け取る第二引数optionsを取ります。戻り値としては、システムがサポートしているロケール識別子の配列が返されます。この戻り値の配列は、入力されたlocalesの順序を維持しつつ、実際にサポートされているロケールのみを含みます。
システムエンジニアを目指す方にとって、多様な言語や地域に対応するアプリケーションを開発する際に、ユーザー環境に合わせた正確な情報表示を実現するための重要なツールとなります。日付時刻の国際化処理において、予期せぬエラーや不適切な表示を防ぐためにこのメソッドを理解し、活用することは非常に価値があります。
構文(syntax)
1Intl.DateTimeFormat.supportedLocalesOf(["en-US", "ja-JP"]);
引数(parameters)
locales, options = {}
- locales: string[] | string: サポートされているロケールを判定したいロケールのリスト。単一のロケール文字列でも指定できます。
- options: Intl.DateTimeFormatOptions = {}: ロケールのマッチングに影響を与えるオプションを指定するオブジェクト。省略した場合、デフォルト値が使用されます。
戻り値(return)
Array<string>
指定されたロケールの中で、Intl.DateTimeFormat がサポートしているロケールの配列を返します。