Intl.DisplayNames.prototype.of()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
Intl.DisplayNames.prototype.of() メソッドは、コードを受け取り、Intl.DisplayNames をインスタンス化するときに指定されたロケールとオプションに基づいて文字列を返します。
試してみましょう
const regionNamesInEnglish = new Intl.DisplayNames(['en'], { type: 'region' });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(['zh-Hant'], {
type: 'region',
});
console.log(regionNamesInEnglish.of('US'));
// 予想される結果: "United States"
console.log(regionNamesInTraditionalChinese.of('US'));
// 予想される結果: "美國"
構文
js
of(code);
引数
code-
与える
codeは、typeによって変わります。- type が "region" である場合、コードは ISO-3166 地域の 2 文字コードまたは three digits UN M49 Geographic Regions である必要があります。
- type が "script" である場合、コードは ISO-15924 文字体系の 4 文字コードである必要があります。
- type が "language" である場合、コードは languageCode ["-" scriptCode] ["-" regionCode ] *("-" variant ) の形である必要があり、これは UTS 35's Unicode Language and Locale Identifiers grammar の unicode_language_id の構文です。 languageCode は 2 文字の ISO 639-1 言語コードまたは 3 文字の ISO 639-2 言語コードです。
- type が "currency" である場合、コードは 3 文字の ISO 4217 通貨コードである必要があります。
返値
その言語における書式化された文字列です。
例
of メソッドの使用
js
let regionNames = new Intl.DisplayNames(["en"], { type: "region" });
regionNames.of("419"); // "Latin America"
let languageNames = new Intl.DisplayNames(["en"], { type: "language" });
languageNames.of("fr"); // "French"
let currencyNames = new Intl.DisplayNames(["en"], { type: "currency" });
currencyNames.of("EUR"); // "Euro"
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-Intl.DisplayNames.prototype.of |