Intl.Locale - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Intl.Locale

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.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Das Intl.Locale-Objekt ist eine standardmäßig integrierte Eigenschaft des Intl-Objekts, das einen Unicode-Locale-Identifikator darstellt.

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"

Das Intl.Locale-Objekt wurde erstellt, um die Manipulation von Unicode-Locale zu erleichtern. Unicode repräsentiert Locales mit einem String, der ein Locale-Identifikator genannt wird. Der Locale-Identifikator besteht aus einem Sprachidentifikator und Erweiterungstags. Sprachidentifikatoren sind der Kern der Locale und bestehen aus Sprache, Schrift, Region und Varianten Subtags. Zusätzliche Informationen über die Locale werden in den optionalen Erweiterungstags gespeichert. Erweiterungstags enthalten Informationen über Aspekte der Locale wie Kalenderart, Uhrzeitsystem und Nummerierungssystem.

Traditionell hat die Intl-API Strings verwendet, um Locales darzustellen, genau wie Unicode. Dies ist eine einfache und leichte Lösung, die gut funktioniert. Das Hinzufügen einer Locale-Klasse erleichtert jedoch das Parsen und Manipulieren von Sprache, Schrift und Region sowie Erweiterungstags. Die folgenden Eigenschaften von Intl.Locale entsprechen Unicode-Locale-Identifikator-Subtags:

Eigenschaft Entsprechender Subtag

language	Sprach-ID, erster Teil
script	Sprach-ID, Teil nach language
region	Sprach-ID, Teil nach script
variants	Sprach-ID, Teil nach region
calendar	ca (Erweiterung)
caseFirst	kf (Erweiterung)
collation	co (Erweiterung)
hourCycle	hc (Erweiterung)
numberingSystem	nu (Erweiterung)
numeric	kn (Erweiterung)

Die obigen Informationen werden genau so bereitgestellt, wie sie sind, wenn das Locale-Objekt erstellt wird, ohne eine externe Datenbank zu konsultieren. Das Intl.Locale-Objekt bietet zusätzlich einige Methoden, die Informationen über die realen Informationen der Locale zurückgeben, wie verfügbare Kalender, Kollationen und Nummerierungssysteme.

Konstruktor

Intl.Locale()

Erstellt ein neues Locale-Objekt.

Instanz-Eigenschaften

Diese Eigenschaften sind auf Intl.Locale.prototype definiert und werden von allen Intl.Locale-Instanzen geteilt.

Intl.Locale.prototype.baseName

Gibt grundlegende, zentrale Informationen über das Locale in Form eines Substrings der vollständigen Datenzeichenkette zurück.

Intl.Locale.prototype.calendar

Gibt den Teil des Locale zurück, der die Kalenderära der Locale angibt.

Intl.Locale.prototype.caseFirst

Gibt zurück, ob bei der Kollation der Locale die Groß- und Kleinschreibung berücksichtigt wird.

Intl.Locale.prototype.collation

Gibt den Kollationstyp für das Locale zurück, der verwendet wird, um Zeichenfolgen entsprechend den Regeln der Locale zu ordnen.

Intl.Locale.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Bei Intl.Locale-Instanzen ist der Ausgangswert der Intl.Locale-Konstruktor.

Intl.Locale.prototype.hourCycle

Gibt das Zeitformatkonvention zurück, das von der Locale verwendet wird.

Intl.Locale.prototype.language

Gibt die Sprache zurück, die mit der Locale verbunden ist.

Intl.Locale.prototype.numberingSystem

Gibt das Ziffernsystem zurück, das von der Locale verwendet wird.

Intl.Locale.prototype.numeric

Gibt zurück, ob die Locale spezielle Kollationsverarbeitung für numerische Zeichen hat.

Intl.Locale.prototype.region

Gibt die Region der Welt (meist ein Land) zurück, die mit der Locale verbunden ist.

Intl.Locale.prototype.script

Gibt das Skript zurück, das für das Schreiben der bestimmten Sprache verwendet wird, die in der Locale verwendet wird.

Intl.Locale.prototype.variants

Gibt die Varianten-Subtags (wie verschiedene Orthografien) zurück, die mit der Locale verbunden sind.

Intl.Locale.prototype[Symbol.toStringTag]

Der Ausgangswert der [Symbol.toStringTag]-Eigenschaft ist die Zeichenfolge "Intl.Locale". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

Intl.Locale.prototype.getCalendars()

Gibt ein Array von verfügbaren Kalender-Identifikatoren entsprechend den Regeln der Locale zurück.

Intl.Locale.prototype.getCollations()

Gibt ein Array der Kollationstypen für das Locale zurück.

Intl.Locale.prototype.getHourCycles()

Gibt ein Array von Stundensystem-Identifikatoren zurück und zeigt entweder die 12-Stunden-Uhr ("h12"), die japanische 12-Stunden-Uhr ("h11"), die 24-Stunden-Uhr ("h23") oder das unbenutzte Format "h24" an.

Intl.Locale.prototype.getNumberingSystems()

Gibt ein Array von Nummerierungssystem-Identifikatoren zurück, die entsprechend den Regeln der Locale verfügbar sind.

Intl.Locale.prototype.getTextInfo()

Gibt den Teil zurück, der die Anordnung der Zeichen ltr (von links nach rechts) oder rtl (von rechts nach links) angibt.

Intl.Locale.prototype.getTimeZones()

Gibt ein Array von Zeitzonen-Identifikatoren zurück, die mit der Locale verbunden sind.

Intl.Locale.prototype.getWeekInfo()

Gibt die Wochenelemente von UTS 35 entsprechend den Locale-Regeln zurück.

Intl.Locale.prototype.maximize()

Ruft die wahrscheinlichsten Werte für Sprache, Skript und Region der Locale basierend auf bestehenden Werten ab.

Intl.Locale.prototype.minimize()

Versucht, Informationen über die Locale zu entfernen, die durch den Aufruf von maximize() hinzugefügt würde.

Intl.Locale.prototype.toString()

Gibt die vollständige Locale-Identifikator-Zeichenkette der Locale zurück.

Beispiele

Grundlegende Nutzung

Im einfachsten Fall nimmt der Intl.Locale()-Konstruktor eine Locale-Identifikator-Zeichenkette als Argument:

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

Verwenden des Locale-Konstruktors mit einem Optionsobjekt

Der Konstruktor nimmt auch ein optionales Konfigurationsobjektargument, das eine beliebige Anzahl von Erweiterungstypen enthalten kann. Zum Beispiel setzen Sie die hourCycle-Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundensystem-Typ und übergeben es dann an den Konstruktor:

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

Polyfill von Intl.Locale in FormatJS
Intl
Kanonische Unicode-Locale-Identifikatoren in der Unicode Locale Data Markup Language 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