Intl.DisplayNames() Konstruktor

new Intl.DisplayNames(locales, options)

Note: Intl.DisplayNames() kann nur mit new konstruiert werden. Der Versuch, es ohne new aufzurufen, führt zu einem TypeError.

locales

Ein String mit einem BCP 47 Sprach-Tag oder einer Intl.Locale Instanz, oder ein Array solcher Locale-Bezeichner. Die Standard-Locale der Laufzeitumgebung wird verwendet, wenn undefined übergeben wird oder keiner der angegebenen Locale-Bezeichner 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 enthält, in der Reihenfolge, in der sie abgerufen werden:

localeMatcher Optional

Der zu verwendende Locale-Abgleichsalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Informationen zu dieser Option finden Sie unter Locale-Identifikation und Verhandlung.

style Optional

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

type

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

fallback Optional

Was von of() zurückgegeben wird, wenn die Eingabe strukturell gültig ist, aber es keinen passenden Anzeigennamen gibt. Mögliche Werte sind:

"code" (Standard)

Gibt den Eingabecode selbst zurück.

"none"

Gibt undefined zurück.

languageDisplay Optional

Wie Sprachbezeichnungen angezeigt werden sollen. Nur zusammen mit type: "language" verwendbar. Mögliche Werte sind:

"dialect" (Standard)

Spezielle regionale Dialekte mit ihrem eigenen Namen anzeigen. Z.B. wird "nl-BE" als "Flemish" angezeigt.

"standard"

Alle Sprachen im Standardformat anzeigen. Z.B. wird "nl-BE" als "Dutch (Belgium)" angezeigt.

TypeError

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

RangeError

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

Bei der grundlegenden Nutzung ohne Angabe einer Locale wird ein formatierter String in der Standard-Locale und mit den Standardeinstellungen zurückgegeben.

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

Beispiel für die Verwendung von dateTimeField als Typoption, dies wird die lokalisierten Datumszeiten-Namen zurückgeben.

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, dies wird die lokalisierten Kalendernamen zurückgeben.

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