Intl.DisplayNames() Konstruktor

new Intl.DisplayNames(locales, options)

Note: Intl.DisplayNames() kann nur mit new konstruiert werden. Ein Aufruf ohne new führt zu einem TypeError.

locales

Ein String mit einem BCP 47 Sprach-Tag oder eine Intl.Locale Instanz, oder ein Array solcher Locale-Identifier. Die Standard-Locale der Laufzeitumgebung wird verwendet, wenn undefined übergeben wird oder keiner der angegebenen Locale-Identifier 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-Abgleichalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Für Informationen zu dieser Option siehe Locale-Erkennung und Verhandlung.

style Optional

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

type

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

fallback Optional

Was von of() zurückgegeben werden soll, wenn die Eingabe strukturell gültig ist, es jedoch keinen übereinstimmenden Anzeigenamen gibt. 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 zusammen mit type: "language" verwendbar. Mögliche Werte sind:

"dialect" (Standard)

Zeigt spezielle regionale Dialekte mit ihrem eigenen Namen an. Z.B. wird "nl-BE" als "Flemish" angezeigt.

"standard"

Zeigt alle Sprachen im Standardformat an. Z.B. wird "nl-BE" als "Dutch (Belgium)" angezeigt.

TypeError

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

RangeError

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

Bei der grundlegenden Verwendung ohne Angabe eines Locale wird ein formatierter String im Standard-Locale mit den Standardoptionen zurückgegeben.

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

Beispiel mit dateTimeField als Typoption, das die lokalisierten Datums- und Zeitnamen-Strings 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 mit calendar als Typoption, das die lokalisierten Kalendernamen-Strings 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 mit 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