Intl.Locale() Konstruktor - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Intl.Locale() Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.

Der Intl.Locale() Konstruktor erstellt Intl.Locale Objekte.

In diesem Artikel

Probieren Sie es aus

const korean = new Intl.Locale("ko", {
  script: "Kore",
  region: "KR",
  hourCycle: "h23",
  calendar: "gregory",
});

const japanese = new Intl.Locale("ja-Jpan-JP-u-ca-japanese-hc-h12");

console.log(korean.baseName, japanese.baseName);
// Expected output: "ko-Kore-KR" "ja-Jpan-JP"

console.log(korean.hourCycle, japanese.hourCycle);
// Expected output: "h23" "h12"

Syntax

js
new Intl.Locale(tag)
new Intl.Locale(tag, options)

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

Der Unicode-Locale-Bezeichner-String. Für die Syntax von Locale-Bezeichner-Strings siehe die Intl Hauptseite. Beachten Sie, dass der Intl.Locale Konstruktor, im Gegensatz zu den meisten anderen Intl Konstruktoren, kein Array von Locales oder undefined akzeptiert.

options

Ein Objekt, das die Konfiguration für die Locale enthält. Die hier angegebenen Optionswerte haben Vorrang vor Erweiterungsschlüsseln im Locale-Bezeichner. Mögliche Eigenschaften sind:

language

Die Sprache. Jeder syntaktisch gültige String entsprechend der unicode_language_subtag Grammatik (2–3 oder 5–8 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

script

Das Schrift-System. Jeder syntaktisch gültige String entsprechend der unicode_script_subtag Grammatik (4 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

region

Die Region. Jeder syntaktisch gültige String entsprechend der unicode_region_subtag Grammatik (entweder 2 Buchstaben oder 3 Ziffern) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

variants

Die Varianten. Es sollte eine durch Bindestriche (-) getrennte Liste von einzigartigen Varianten-Tags sein, wobei jedes Tag ein syntaktisch gültiger String entsprechend der unicode_variant_subtag Grammatik ist (entweder 5–8 alphanumerische Zeichen oder eine Ziffer gefolgt von 3 alphanumerischen Zeichen), aber die Implementierung erkennt nur bestimmte Arten.

calendar

Der Kalender. Jeder syntaktisch gültige String entsprechend der type Grammatik (ein oder mehrere Segmente von 3–8 alphanumerischen Zeichen, verbunden durch Bindestriche) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

collation

Die Kollation. Jeder syntaktisch gültige String entsprechend der type Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

numberingSystem

Das Zahlsystem. Jeder syntaktisch gültige String entsprechend der type Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

caseFirst

Die Case-First-Sortieroption. Mögliche Werte sind "upper", "lower", oder "false".

hourCycle

Der Stundenzyklus. Mögliche Werte sind "h23", "h12", "h11", oder das praktisch unbenutzte "h24", welche in Intl.Locale.prototype.getHourCycles erklärt werden.

numeric

Die numerische Sortieroption. Ein boolean.

Beispiele

Grundlegende Verwendung

Im einfachsten Fall nimmt der Intl.Locale() Konstruktor einen Locale-Bezeichner-String als Argument:

const us = new Intl.Locale("en-US");

Verwendung des Locale-Konstruktors mit einem Optionsobjekt

Der Konstruktor kann auch ein optionales Konfigurationsobjekt als Argument nehmen, das verschiedene Erweiterungstypen enthalten kann. Setzen Sie zum Beispiel die hourCycle Eigenschaft des Konfigurationsobjekts auf den gewünschten Stundenzylus-Typ und übergeben Sie es dann an den Konstruktor:

js
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

Intl.Collator
Kanonische Unicode-Locale-Identifikatoren in der Unicode-Locale-Datenmarkupsprache-Spezifikation

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Intl.Locale
Konstruktor
1. Intl.Locale()
Instanzmethoden
1. getCalendars()
2. getCollations()
3. getHourCycles()
4. getNumberingSystems()
5. getTextInfo()
6. getTimeZones()
7. getWeekInfo()
8. maximize()
9. minimize()
10. toString()
Instanzeigenschaften
1. baseName
2. calendar
3. caseFirst
4. collation
5. hourCycle
6. language
7. numberingSystem
8. numeric
9. region
10. script
11. variants
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.ListFormat
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter

Intl.Locale() Konstruktor

In diesem Artikel

Probieren Sie es aus

Syntax

Parameter

Beispiele

Grundlegende Verwendung

Verwendung des Locale-Konstruktors mit einem Optionsobjekt

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN