Intl.DisplayNames()-Konstruktor

locales

Eine Zeichenkette mit einem BCP 47-Sprachtag oder einer Intl.Locale-Instanz oder ein Array solcher Locale-Kennungen. Die Standard-Locale der Laufzeitumgebung wird verwendet, wenn undefined übergeben wird oder wenn keine der angegebenen Locale-Kennungen unterstützt wird. Für die allgemeine Form und Interpretation des locales-Arguments siehe die Parameterbeschreibung auf der Intl-Hauptseite.

options

Ein Objekt, das die folgenden Eigenschaften in der Reihenfolge enthält, in der sie abgerufen werden:

localeMatcher Optional

Der zu verwendende Locale-Abgleichalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Für Informationen über diese Option siehe Lokalisierung und Verhandeln von Locales.

style Optional

Der zu verwendende Formatierungsstil. Mögliche Werte sind "narrow", "short" und "long"; der Standardwert ist "long".

type

Der Typ der Anzeigennamen, die von of() zurückgegeben werden. Mögliche Werte sind "language", "region", "script", "currency", "calendar" und "dateTimeField".

fallback Optional

Was von of() zurückzugeben ist, wenn die Eingabe strukturell gültig ist, aber kein passender Anzeigename gefunden wird. Mögliche Werte sind:

"code" (Standard)

Gibt den Eingabecode selbst zurück.

"none"

Gibt undefined zurück.

languageDisplay Optional

Wie Sprachennamen angezeigt werden sollen. Nur in Verbindung mit type: "language" verwendbar. Mögliche Werte sind:

"dialect" (Standard)

Zeigt spezielle regionale Dialekte mit ihrem eigenen Namen an. Zum Beispiel wird "nl-BE" als "Flämisch" angezeigt.

"standard"

Zeigt alle Sprachen im Standardformat an. Zum Beispiel wird "nl-BE" als "Niederländisch (Belgien)" angezeigt.

TypeError

Wird ausgelöst, wenn options.type nicht angegeben wird.

RangeError

Wird ausgelöst, wenn locales oder options ungültige Werte enthalten.

Bei der grundlegenden Verwendung ohne Angabe einer Locale wird eine formatierte Zeichenkette in der Standard-Locale und mit Standardoptionen zurückgegeben.

console.log(new Intl.DisplayNames([], { type: "language" }).of("US"));
// 'us'

Beispiel für die Verwendung von dateTimeField als Typoption, die die lokalisierten Datum-Zeit-Namenstrings zurückgibt.

const dn = new Intl.DisplayNames("pt", { type: "dateTimeField" });
console.log(dn.of("era")); // 'era'
console.log(dn.of("year")); // 'ano'
console.log(dn.of("month")); // 'mês'
console.log(dn.of("quarter")); // 'trimestre'
console.log(dn.of("weekOfYear")); // 'semana'
console.log(dn.of("weekday")); // 'dia da semana'
console.log(dn.of("dayPeriod")); // 'AM/PM'
console.log(dn.of("day")); // 'dia'
console.log(dn.of("hour")); // 'hora'
console.log(dn.of("minute")); // 'minuto'
console.log(dn.of("second")); // 'segundo'

Beispiel für die Verwendung von calendar als Typoption, die die lokalisierten Kalendernamenstrings zurückgibt.

const dn = new Intl.DisplayNames("en", { type: "calendar" });
console.log(dn.of("roc")); // 'Minguo Calendar'
console.log(dn.of("gregory")); // 'Gregorian Calendar'
console.log(dn.of("chinese")); // 'Chinese Calendar'

Beispiel für die Verwendung von language als Typ mit languageDisplay-Optionen.

// Using `dialect` option
const dnDialect = new Intl.DisplayNames("en", {
  type: "language",
  languageDisplay: "dialect",
});
console.log(dnDialect.of("en-GB")); // 'British English'

// Using `standard` option
const dnStd = new Intl.DisplayNames("en", {
  type: "language",
  languageDisplay: "standard",
});
console.log(dnStd.of("en-GB")); // 'English (United Kingdom)'

• Intl.DisplayNames
• Intl.supportedValuesOf()
• Intl