Intl.DisplayNames.prototype.of()

Probieren Sie es aus

const regionNamesInEnglish = new Intl.DisplayNames(["en"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
  type: "region",
});

console.log(regionNamesInEnglish.of("US"));
// Expected output: "United States"

console.log(regionNamesInTraditionalChinese.of("US"));
// Expected output: "美國"

Syntax

of(code)

Parameter

code

Der bereitzustellende code hängt vom type ab:

• Ist der Typ "region", sollte code entweder ein zwei-buchstabiger ISO 3166 Regionscode oder ein drei-ziffriger UN M49 geografischer Regionen-Code sein. Er muss der Grammatik des unicode_region_subtag folgen. Verwenden Sie Großbuchstabencodes (z.B. "US"), da Kleinbuchstabencodes (z.B. "us") möglicherweise nicht überall zuverlässig funktionieren.
• Ist der Typ "script", sollte code ein vier-buchstabiger ISO 15924 Skriptcode sein. Er muss der Grammatik des unicode_script_subtag folgen.
• Ist der Typ "language", sollte code mit dem unicode_language_id Nichtterminal übereinstimmen.
• Ist der Typ "currency", sollte code ein drei-buchstabiger ISO 4217 Währungscode sein. Er muss genau drei alphabetische Zeichen haben.
• Ist der Typ "dateTimeField", sollte code einer der folgenden sein: "era", "year", "quarter", "month", "weekOfYear", "weekday", "day", "dayPeriod", "hour", "minute", "second", "timeZoneName".
• Ist der Typ "calendar", sollte code ein Kalenderschlüssel sein. Er muss der type-Grammatik eines Unicode-Lokalisierungsidentifikators folgen.

Rückgabewert

Ein sprachspezifisch formatierter String oder undefined, wenn keine Daten für die Eingabe vorhanden sind und fallback "none" ist.

Ausnahmen

RangeError

Wird ausgelöst, wenn code strukturell ungültig für den angegebenen type ist.

Beispiele

Verwendung der of Methode

const regionNames = new Intl.DisplayNames("en", { type: "region" });
regionNames.of("419"); // "Latin America"

const languageNames = new Intl.DisplayNames("en", { type: "language" });
languageNames.of("fr"); // "French"

const currencyNames = new Intl.DisplayNames("en", { type: "currency" });
currencyNames.of("EUR"); // "Euro"

const languageNamesStandard = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "standard",
});
languageNamesStandard.of("fr-CA"); // "français (Canada)"

const languageNamesDialect = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "dialect",
});
languageNamesDialect.of("fr-CA"); // "français canadien"

Verwendung von Fallback

Wenn Intl.DisplayNames mit fallback: "code" erstellt wird, gibt die of() Methode den code zurück, wenn die Eingabe strukturell gültig aussieht, aber keine Daten für die Eingabe vorhanden sind. Ist fallback "none", wird undefined zurückgegeben.

console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZL"),
); // "ZL"

console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "none" }).of("ZL"),
); // undefined

Dies gilt jedoch nur, wenn der code strukturell gültig ist. Wenn z.B. type "region" ist, aber code nicht der Grammatik des unicode_region_subtag (2 alphabetische Zeichen oder 3 numerische Zeichen) folgt, wird ein RangeError direkt geworfen, anstatt den Fallback zu verwenden.

console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZLC"),
); // throws RangeError: invalid value "ZLC" for option region

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Intl.DisplayNames