Internationalisierung

Überblick

Das Intl-Objekt ist stark an Anwendungsfällen orientiert. Es bietet ein separates Objekt für jeden Anwendungsfall, der lokalisierungsspezifische Logik erfordert. Derzeit bietet es die folgenden Funktionen:

• Informationen über eine Locale erhalten mittels Intl.Locale.
• Daten formatieren mittels Intl.DateTimeFormat, Intl.DurationFormat, Intl.ListFormat, Intl.NumberFormat und Intl.RelativeTimeFormat.
• Kollation (d.h. Vergleich von Strings zum Sortieren oder Suchen) mittels Intl.Collator.
• Pluralformen auswählen mittels Intl.PluralRules.
• Text segmentieren in Einheiten wie Wörter, Sätze oder Grapheme mittels Intl.Segmenter.
• Den angezeigten Namen erhalten für Währungen, Sprachen, Schriften, Regionen und Zeitzonen mittels Intl.DisplayNames.

Die meisten Intl-APIs haben ein ähnliches Design (Intl.Locale ist die einzige Ausnahme). Sie beginnen mit der Konstruktion einer Instanz mit der gewünschten Locale und den Optionen. Dies definiert einen Satz von Regeln für die gewünschte Operation (Formatierung, Kollation, Segmentierung usw.). Dann, wenn Sie die Methode auf der Instanz aufrufen, wie format(), compare() oder segment(), wendet das Objekt die angegebene Regel auf die übergebenen Daten an.

Das allgemeine Signatur des Konstruktors ist:

Ein String mit einem BCP 47 Sprach-Tag oder eine Intl.Locale-Instanz oder ein Array solcher Locale-Identifikatoren. Die Standardeinstellung der Laufzeit wird verwendet, wenn undefined übergeben wird oder wenn keiner der angegebenen Locale-Identifikatoren unterstützt wird. Für die allgemeine Form und Interpretation des locales-Arguments siehe die Parameterbeschreibung auf der Intl-Hauptseite.

Ein Objekt, das Eigenschaften enthält, die spezifische Aspekte der Operation anpassen, was der Schlüssel zum Verständnis der Verwendung jedes Intl-Objekts ist.

Locale-Informationen

Locales liegen allen Verhaltensweisen von Intl zugrunde. Eine Locale ist ein Satz von Konventionen, dargestellt in der Intl-API durch das Intl.Locale-Objekt. Alle Intl-Konstruktoren, die Sprach-Tags akzeptieren, akzeptieren auch Intl.Locale-Objekte.

Jede Locale wird hauptsächlich durch vier Dinge definiert: eine language, ein script, eine region und manchmal einige variants. Wenn sie in dieser Reihenfolge verbunden werden, bilden sie ein BCP 47 Sprach-Tag.

• Die Sprache ist der wichtigste Teil der Locale und ist obligatorisch. Wenn eine einzelne Sprache angegeben wird, wie en oder fr, gibt es Algorithmen, um den Rest der Informationen zu folgern (siehe Intl.Locale.prototype.maximize()).
• Oft möchte man jedoch auch die Region angeben, da sich die Konventionen in Regionen, die dieselbe Sprache sprechen, drastisch unterscheiden können. Zum Beispiel ist das Datumsformat in den USA MM/TT/JJJJ, während es im Vereinigten Königreich TT/MM/JJJJ lautet, daher ist es wichtig, en-US oder en-GB anzugeben.
• Sie können auch ein Script angeben. Das Script ist das Schriftsystem oder die Zeichen, die verwendet werden, um die Sprache zu transkribieren. In der Praxis ist das Script oft unnötig, da die in einer bestimmten Region verwendete Sprache normalerweise nur in einem Schriftsystem geschrieben wird. Es gibt jedoch Ausnahmen wie die serbische Sprache, die sowohl in der lateinischen als auch in der kyrillischen Schrift geschrieben werden kann (sr-Latn und sr-Cyrl), oder die chinesische Sprache, die sowohl in der vereinfachten als auch in der traditionellen Schrift geschrieben werden kann (zh-Hans und zh-Hant).
• Die Varianten werden selten verwendet. In der Regel bezeichnen sie unterschiedliche Orthographien; zum Beispiel hat Deutsch die 1901 und 1996 Orthographie-Varianten, die als de-1901 und de-1996 geschrieben werden.

Eine Locale enthält auch einen Satz von Konventionen, die von dieser speziellen Kultur verwendet werden:

Diese Eigenschaften können explizit angegeben werden, wenn das Intl.Locale-Objekt erstellt oder Sprach-Tags an andere Intl-Konstruktoren übergeben werden. Es gibt zwei Möglichkeiten dies zu tun — sie an das Sprach-Tag anhängen oder sie als Optionen angeben.

• Um sie an das Sprach-Tag anzuhängen, fügen Sie zuerst den String -u (was "Unicode-Erweiterung" bedeutet) an, dann das Erweiterungs-Untertitel wie oben angegeben und dann den Wert.
• Um sie als Optionen anzugeben, fügen Sie einfach den Eigenschaftsnamen wie oben angegeben zusammen mit seinem Wert dem options-Objekt hinzu.

Mithilfe von Intl.DateTimeFormat als Beispiel erstellen beide der folgenden Zeilen einen Formatierer, der Daten im hebräischen Kalender formatiert:

Nicht erkannte Eigenschaften werden ignoriert, sodass Sie die gleiche Syntax wie oben mit Intl.NumberFormat verwenden können, aber es wird nichts anderes tun, als einfach en-US zu übergeben, da die Zahlenformatierung die calendar-Eigenschaft nicht verwendet.

Es ist schwierig, die Standardwerte dieser Locale-Konventionen zu ermitteln. new Intl.Locale("en-US").calendar gibt undefined zurück, da das Locale-Objekt nur die Informationen enthält, die Sie ihm übergeben haben. Der Standardkalender ist theoretisch abhängig von der API, mit der Sie den Kalender verwenden, sodass Sie den Standardkalender von en-US, wie er von Intl.DateTimeFormat verwendet wird, mit seiner resolvedOptions()-Methode ermitteln können. Das Gleiche gilt für andere Eigenschaften.

Intl.Locale-Objekte tun zwei Dinge gleichzeitig: Sie repräsentieren ein geparstes BCP 47 Sprach-Tag (wie oben demonstriert) und sie liefern Informationen über diese Locale. Alle ihre Eigenschaften, wie calendar, werden nur aus der Eingabe extrahiert, ohne dabei eine Datenquelle nach Standardwerten abzufragen. Auf der anderen Seite hat es eine Gruppe von Methoden, um reale Informationen über die Locale zu erfragen. Zum Beispiel ergänzen die Methoden getCalendars(), getHourCycles(), getNumberingSystems() und getCollations() die Eigenschaften calendar, hourCycle, numberingSystem und collation, und jede gibt ein Array bevorzugter Werte für diese Eigenschaft zurück.

Intl.Locale-Instanzen beinhalten auch andere Methoden, die nützliche Informationen preisgeben, wie getTextInfo(), getTimeZones(), und getWeekInfo().

Die Locale ermitteln

Eine gemeinsame Frage zur Internationalisierung lautet: Wie weiß ich, welche Locale ich nutzen soll?

Die offensichtlichste Antwort lautet: "was der Nutzer bevorzugt." Browser stellen die Spracheinstellungen des Nutzers über die navigator.languages-Eigenschaft zur Verfügung. Dies ist ein Array von Sprach-Identifikatoren, das direkt an den Konstruktor des Formatierers übergeben werden kann – mehr dazu später. Der Nutzer kann diese Liste in seinen Browsereinstellungen konfigurieren. Sie können auch ein leeres Array oder undefined übergeben, wodurch die Standardeinstellung des Browsers verwendet wird.

Allerdings liefert dies möglicherweise nicht immer das wünschenswerteste Ergebnis. Von Intl formatierte Strings stellen einen winzigen Bruchteil des auf Ihrer Website angezeigten Texts dar; die meisten lokalisierten Inhalte werden von Ihnen, dem Website-Entwickler, bereitgestellt. Angenommen, Ihre Website wird nur in zwei Sprachen angeboten: Englisch und Französisch. Wenn ein japanischer Nutzer Ihre Website besucht und erwartet, diese auf Englisch zu nutzen, wird er verwirrt sein, wenn er den englischen Text mit Zahlen und Daten auf Japanisch sieht!

In der Regel möchten Sie nicht die Standardsprache des Browsers verwenden. Vielmehr möchten Sie die gleiche Sprache verwenden, in der der Rest Ihrer Website angeboten wird. Angenommen, Ihre Website hat einen Sprachschalter, der die Auswahl des Nutzers irgendwo speichert — Sie könnten diese direkt verwenden.

Falls Ihre Website ein Backend hat, das die Sprache basierend auf dem Accept-Language-Header des Nutzers dynamisch auswählt und entsprechend anderes HTML zurücksendet, könnten Sie auch die [HTMLElement.lang]-Eigenschaft des HTML-Elements verwenden: new Intl.NumberFormat(document.documentElement.lang).

Falls Ihre Website nur in einer Sprache angeboten wird, könnten Sie die Locale direkt in Ihrem Code hartkodieren: new Intl.NumberFormat("en-US").

Wie bereits erwähnt, können Sie dem Konstruktor auch ein Array von Locales übergeben, das eine Liste von Fallback-Optionen darstellt. Das erste Beispiel mit navigator.languages ist ein Beispiel hierfür: Wenn die erste nutzer-configurierte Locale nicht für die bestimmte Operation unterstützt wird, wird die nächste versucht, und so weiter, bis eine angeforderte Locale gefunden wird, für die die Laufzeit Daten hat. Sie können dies auch manuell tun. Im nachstehenden Beispiel spezifizieren wir eine Liste von Locales in absteigender Reihenfolge der Spezifität, die alle Sprachen darstellen, die ein chinesischer Sprecher aus Hongkong wahrscheinlich versteht, sodass der Formatierer die spezifischste von ihm unterstützte Locale auswählt.

Es gibt keine API, um alle unterstützten Locales aufzulisten, aber es gibt ein paar Methoden zum Umgang mit der Locale-Liste:

• Intl.getCanonicalLocales(): Diese Funktion nimmt eine Liste von Locale-Identifikatoren und gibt eine Liste kanonisierter Locale-Identifikatoren zurück. Dies ist nützlich, um den Kanonisierungsprozess für jeden Intl-Konstruktor zu verstehen.
• Die supportedLocalesOf()-statische Methode auf jedem Intl-Objekt (wie Intl.DateTimeFormat.supportedLocalesOf()): Diese Methode nimmt die gleichen Argumente wie der Konstruktor (locales und options) und gibt eine Teilmenge der gegebenen Locale-Tags zurück, die mit den gegebenen Daten übereinstimmen. Dies ist nützlich, um zu verstehen, welche Locales von der Laufzeit für eine bestimmte Operation unterstützt werden, zum Beispiel um einen Sprachschalter mit nur den unterstützten Sprachen zu zeigen.

Verständnis des Rückgabewertes

Die zweite gemeinsame Frage für alle Objekte lautet "was gibt die Methode zurück?" Diese Frage lässt sich nicht über den Aufbau oder Typ des zurückgegebenen Wertes hinaus leicht beantworten, da es keine normative Spezifikation gibt, die genau vorschreibt, was genau zurückgegeben werden sollte. Die meiste Zeit ist das Ergebnis einer Methode konsistent. Allerdings kann sich die Ausgabe zwischen Implementierungen unterscheiden, sogar innerhalb derselben Locale — Unterschiede in Ausgaben sind ausdrücklich von der Spezifikation vorgesehen und erlaubt. Es ist möglicherweise auch nicht das, was Sie erwarten. Zum Beispiel könnte der von format() zurückgegebene String geschützte Leerzeichen oder von bidirektionalen Steuerzeichen umgeben sein. Vergleichen Sie die Ergebnisse einer Intl-Methode nie mit fest kodierten Konstanten; sie sollten nur Nutzern angezeigt werden.

Natürlich klingt diese Antwort unbefriedigend, denn die meisten Entwickler wollen durchaus kontrollieren, wie die Ausgabe aussieht — zumindest will man nicht, dass Nutzer durch unsinnige Ausgaben verwirrt werden. Hier sind einige Richtlinien, wenn Sie Tests durchführen möchten, sei es automatisiert oder manuell:

• Testen Sie alle Locales, die Ihr Nutzer möglicherweise verwenden könnte. Dies ist einfacher, wenn Sie eine feste Anzahl von unterstützten Locales haben (zum Beispiel über einen Sprachschalter). Wenn Sie verwenden, was der Nutzer bevorzugt, könnten Sie einige gängige für Ihre Nutzer auswählen. Beachten Sie allerdings, dass das, was der Nutzer sieht, variieren könnte. Normalerweise können Sie Benutzerpräferenzen über die Konfiguration des Testrunners simulieren oder die Intl-Konstruktoren mocken.
• Testen Sie es auf mehreren JavaScript-Engines. Die Intl-API wird direkt von der JavaScript-Engine implementiert, erwarten Sie also, dass Node.js und Chrome (die beide V8 verwenden) dasselbe Ergebnis haben, während Firefox (das SpiderMonkey verwendet) möglicherweise ein anderes Ergebnis hat. Auch wenn alle Engines wahrscheinlich die CLDR-Daten verwenden, verarbeiten sie diese in der Regel auf verschiedene Weise nach. Einige Browsereinstellungen (zum Beispiel um die Installationsgröße zu reduzieren) können ebenfalls beeinflussen, welche Locales und Optionen unterstützt werden.
• Gehen Sie nicht von einer bestimmten Ausgabe aus. Das bedeutet, dass Sie die Ausgabe nicht von Hand niederschreiben sollten, wie expect(result).toBe("foo"). Verwenden Sie stattdessen Snapshot-Tests oder kopieren Sie den String-Wert aus der Ausgabe eines Testlaufs.

Daten formatieren

Ein Hauptanwendungsfall von Intl ist das Ausgeben von lokalisierungsspezifischen Texten, die strukturierte Daten darstellen. Dies ähnelt Übersetzungssoftware, aber anstatt Ihnen die Übersetzung beliebigen Textes zu ermöglichen, nimmt es Daten wie Daten, Zahlen und Listen und formatiert sie gemäß lokalisierungsbezogenen Regeln.

Die Objekte Intl.DateTimeFormat, Intl.DurationFormat, Intl.ListFormat, Intl.NumberFormat, und Intl.RelativeTimeFormat formatieren jeweils eine Art von Daten. Jede Instanz bietet zwei Methoden:

• format(): Nimmt ein Stück Daten und gibt einen String zurück, der die Formatierungsregel wie von der Locale und den Optionen bestimmt verwendet.
• formatToParts(): Nimmt dieselben Daten und gibt denselben String zurück, allerdings aufgeteilt in Teile, wobei jeder Teil ein Objekt mit einem type und einem value ist. Dies ist nützlich für fortgeschrittene Anwendungsfälle, wie das Einfügen des formatierten Textes in andere Texte.

Zum Beispiel hier eine typische Verwendung des Intl.NumberFormat-Objekts:

Sie müssen nicht immer ein Formatierer-Objekt konstruieren, um Strings zu formatieren. Für gelegentliche Zwecke können Sie auch direkt die toLocaleString()-Methode auf den Daten aufrufen, indem Sie die Locale und Optionen als Argumente übergeben. Die toLocaleString()-Methode wird von Temporal.PlainDate.prototype.toLocaleString(), Temporal.Duration.prototype.toLocaleString(), Number.prototype.toLocaleString(), und so weiter implementiert. Lesen Sie die Dokumentation für die Daten, die Sie formatieren, um zu sehen, ob sie toLocaleString() unterstützen und welche Formatierer-Optionen es entspricht.

Beachten Sie, dass toLocaleString() potenziell weniger effizient sein kann als die Verwendung eines Formatierer-Objekts, da jedes Mal, wenn toLocaleString aufgerufen wird, eine Suche in einer großen Datenbank von Lokalisierungsstrings durchgeführt werden muss. Wenn die Methode viele Male mit denselben Argumenten aufgerufen wird, ist es besser, ein Formatierer-Objekt zu erstellen und seine format()-Methode zu verwenden, da ein Formatierer-Objekt die ihm übergebenen Argumente speichert und sich entscheidet, einen Ausschnitt der Datenbank im Cache zu halten, sodass zukünftige format-Aufrufe Lokalisierungsstrings innerhalb eines eingeschränkteren Kontexts suchen können.

Datums- und Uhrzeitformatierung

Intl.DateTimeFormat formatiert Daten und Zeiten sowie Bereiche von Daten und Zeiten. Das DateTimeFormat-Objekt akzeptiert Datum/Zeit-Eingaben in einer der folgenden Formen: Date, Temporal.PlainDateTime, Temporal.PlainTime, Temporal.PlainDate, Temporal.PlainYearMonth, oder Temporal.PlainMonthDay.

Gängige Anwendungsfälle für lokalisierte Datums- und Zeitformatierung sind wie folgt:

• Das gleiche Datum und die gleiche Uhrzeit in einem anderen Kalendersystem ausgeben, wie dem islamischen, hebräischen oder chinesischen Kalender.
• Das gleiche reale Zeitmoment (Moment) ausgeben, jedoch in einer anderen Zeitzone.
• Selektives Ausgeben bestimmter Komponenten des Datums und der Uhrzeit, wie nur des Jahres und des Monats, und deren spezifische Darstellung (wie "Donnerstag" oder "Do").
• Datum gemäß lokalisierungsbezogenen Konventionen ausgeben, wie MM/TT/JJJJ wie in den USA, TT/MM/JJJJ wie im Vereinigten Königreich oder JJJJ/MM/TT wie in Japan.
• Uhrzeit gemäß lokalisierungsbezogenen Konventionen ausgeben, wie 12-Stunden- oder 24-Stunden-Uhr.

Um zu entscheiden, wie der formatierte String aussehen soll, wählen Sie zunächst den Kalender (der Jahr-, Monat-, Wochen-, und Tagesberechnung beeinflusst) und die Zeitzone (die das genaue Zeitmoment sowie möglicherweise das Datum beeinflusst). Dies geschieht mithilfe der zuvor genannten calendar-Option (oder dem -ca- Erweiterungsschlüssel im Locale-Identifikator) und der timeZone-Option.

• Date-Objekte repräsentieren ein einzigartiges Moment in der Zeitzone des Nutzers und im ISO 8601-Kalender (wie von Methoden wie Date.prototype.getHours() und Date.prototype.getMonth() berichtet). Sie werden in den angegebenen calendar und die timeZone konvertiert, indem das Moment erhalten bleibt, sodass die Datums- und Zeitkomponenten sich ändern können.
• Die verschiedenen Temporal-Objekte besitzen bereits einen eingebauten Kalender, sodass die calendar-Option konsistent mit dem Kalender des Objekts sein muss—es sei denn, der Kalender des Datums ist "iso8601", in welchem Fall es in den angeforderten calendar konvertiert wird. Diese Objekte besitzen keine Zeitzone, sodass sie direkt in der gegebenen timeZone ohne Konvertierung angezeigt werden.

Hier zeigen wir, wie die Kombination von calendar- und timeZone-Konfigurationen zu unterschiedlichen Darstellungen desselben Moments führen.

Die Ausgabe sieht so aus:

Ein Datum/Uhrzeit besteht aus den folgenden Komponenten: weekday, era, year, month, day, dayPeriod, hour, minute, second, fractionalSecondDigits, und timeZoneName. Ihre nächste Entscheidung ist, welche Komponenten in der Ausgabe enthalten sein sollen und welche Formen sie annehmen sollen. Sie haben zwei Möglichkeiten:

• Sie können jede Komponente manuell konfigurieren, indem Sie Optionen mit demselben Namen wie die Komponente verwenden. Nur die von Ihnen spezifizierten Komponenten werden in der Ausgabe enthalten sein, mit der angegebenen Form.
• Sie können die Abkürzungen dateStyle und timeStyle verwenden, die vordefinierte Sätze von Komponenten sind. Sie erweitern sich zu einem Satz von Komponentenoptionen abhängig von der Locale.

Sie sollten eine dieser beiden Methoden wählen, da sie gegenseitig exklusiv sind. Die gleichzeitige Verwendung beider Methoden führt zu einem Fehler.

Grundsätzlich sucht das DateTimeFormat-Objekt nach Anforderung einer Kombination von Komponenten nach einer "Schablone", die mit den angeforderten Komponenten übereinstimmt, sodass es nur die Werte eins nach dem anderen ausfüllen muss. Nicht jede Kombination von Komponenten hat eine vordefinierte Schablone. DateTimeFormat hat eine formatMatcher-Option, die entscheidet, wie zu verhandeln ist, indem Komponenten länger oder kürzer gemacht werden als angefordert, oder indem Komponenten weggelassen oder hinzugefügt werden. Es wird ziemlich technisch, daher sollten Sie das Intl.DateTimeFormat() Nachschlagewerk lesen, um besser zu verstehen, wie es damit umgeht.

Hier, demonstrieren wir einige gängige Methoden zum Formatieren der Komponenten:

Es gibt weitere Anpassungsoptionen. Beispielsweise können Sie die hourCycle-Option verwenden, um die Uhrzeit im 12-Stunden- oder 24-Stunden-Format anzuzeigen und Mitternacht/Mittag als 12:00 oder 0:00 anzuzeigen. Sie können auch die numberingSystem-Option verwenden, um Zahlen in einem anderen Zahlensystem anzuzeigen.

Neben format() gibt es eine zweite wichtige Methode, formatRange(), die einen Bereich von Daten oder Zeiten formatiert. Sie nimmt zwei DateTime-Darstellungen des gleichen Typs, formatiert jede einzeln, verbindet sie mit einem Bereichsseparator (wie der en-Dash), und entfernt gegebenenfalls doppelte Teile.

Zahlenformatierung

Die Zahlenformatierung erfolgt mit dem Intl.NumberFormat-Objekt. Das NumberFormat-Objekt akzeptiert Eingaben in Form von Zahlen, Strings oder BigInt-Werten. Das Übergeben eines Strings oder BigInt anstelle einer Zahl ermöglicht Ihnen, Zahlen zu formatieren, die zu groß oder zu klein sind, um als JavaScript-Zahl genau dargestellt zu werden.

Gängige Anwendungsfälle für die lokalisierte Zahlenformatierung sind wie folgt:

• Die Zahl in einem anderen Zahlensystem (Script) ausgeben, wie Chinesisch, Arabisch oder Römisch.
• Die Zahl mit lokalisierungsbezogenen Konventionen ausgeben, wie dem Dezimaltrennzeichen (".'' in Englisch, aber "," in vielen europäischen Kulturen), oder der Zahlenzusammenstellung (3 Ziffern in Englisch, aber in anderen Kulturen könnten es 4 oder 2 sein, und sie könnten ",", " " oder "." verwenden).
• Die Zahl im exponentiellen Notationsformat wie "3,7 Millionen" oder "2 Tausend" ausgeben.
• Die Zahl als Währung ausgeben und bestimmte Währungssymbole und Rundungsregeln anwenden. Zum Beispiel sind Geldbeträge unter einem Cent in den USA oder unter einem Yen in Japan möglicherweise nicht sinnvoll anzuzeigen.
• Die Zahl als Prozentsatz ausgeben und lokalisierungsbezogene Umwandlungs- und Formatierungsregeln anwenden.
• Die Zahl mit Einheiten ausgeben, wie "Meter" oder "Liter", mit übersetzten Einheitsnamen.

Um zu entscheiden, wie der formatierte String aussehen soll, wählen Sie zuerst das Zahlensystem (was die Zeichen beeinflusst, die für die Ziffern verwendet werden). Der Zweck eines Zahlensystems wurde bereits in den Locale-Informationen diskutiert. Eine weitere Option, die Sie entscheiden müssen, ist der style, der den Kontext festlegt, in welchem die Zahl dargestellt wird, und möglicherweise die Standardwerte anderer Optionen beeinflusst. Er ist eines von "decimal", "percent", "currency", oder "unit". Wenn Sie Währungen formatieren möchten, müssen Sie auch die currency-Option angeben. Wenn Sie Einheiten formatieren möchten, müssen Sie auch die unit-Option angeben.

Die Ausgabe sieht so aus:

Die nächste Gruppe von Optionen spezifizieren alle, wie der numerische Teil aussehen soll. Zunächst möchten Sie möglicherweise extrem große Werte auf eine lesbarere Weise darstellen. Sie können die notation-Option auf "scientific" oder "engineering" setzen, die beide die 1.23e+6-Notation verwenden. Der Unterschied ist, dass letztere Vielfache von 3 für den Exponenten verwendet, um die Mantisse (den Teil vor dem e-Symbol) zwischen 1 und 1000 zu halten, während die Erstere für den Exponenten jede ganze Zahl verwenden kann und die Mantisse zwischen 1 und 10 hält. Sie können auch notation auf "compact" setzen, um eine für Menschen lesbarere Notation zu verwenden.

Die Ausgabe sieht so aus:

Dann möchten Sie möglicherweise die Zahl runden (falls Sie notation angegeben haben, dann nur den Mantissenteil), sodass Sie keine Zahl anzeigen, die zu lang ist. Dies sind die Ziffernoptionen, die umfassen:

• minimumIntegerDigits
• minimumFractionDigits
• maximumFractionDigits
• minimumSignificantDigits
• maximumSignificantDigits
• roundingPriority
• roundingIncrement
• roundingMode

Die genaue Interaktion dieser Optionen ist recht komplex und es ist nicht lohnenswert, sie hier zu behandeln. Sie sollten die Ziffernoptionen nachlesen, um mehr Details zu erfahren. Dennoch ist das grundsätzliche Konzept einfach: Zunächst ermitteln wir die Anzahl der Dezimalstellen, die wir beibehalten möchten, und dann runden wir überzählige Dezimalstellen ab oder auf, abhängig vom Wert der letzten Ziffer.

Die Ausgabe sieht so aus:

Es gibt weitere Anpassungsoptionen. Beispielsweise können Sie die Optionen useGrouping und signDisplay verwenden, um anzupassen, ob und wie die Gruppentrennzeichen (wie "," in "1,234,567.89") und das Vorzeichen angezeigt werden sollen. Beachten Sie jedoch, dass die verwendeten Zeichen für Gruppentrennzeichen, Dezimaltrennpunkt und Vorzeichen lokalisierungsabhängig sind, sodass Sie sie nicht direkt anpassen können.

Neben format() gibt es eine zweite wichtige Methode, formatRange(), die einen Bereich von Zahlen formatiert. Sie nimmt zwei Zahlendarstellungen, formatiert jede einzeln, verbindet sie mit einem Bereichsseparator (wie der en-Dash), und entfernt gegebenenfalls doppelte Teile.

Listenformatierung

Sie haben möglicherweise bereits Code geschrieben, der dies tut:

Dieser Code ist nicht internationalisiert. In einigen Sprachen ist der Listentrenner kein Komma. In den meisten Sprachen (einschließlich Englisch) benötigen Sie eine Konjunktion vor dem letzten Element. Aber auch nur das manuelle Hinzufügen eines "und" macht es nicht korrekt für alle Englischsprecher, weil es die Debatte um Oxford-Kommas im Englischen gibt: "apple, banana, and cherry" vs. "apple, banana and cherry".

Das Intl.ListFormat-Objekt löst dieses Problem. Es nimmt ein Array von Strings und verbindet sie auf eine lokalisierungsabhängige Weise, sodass das Ergebnis eine Konjunktion (und), Disjunktion (oder) oder eine Liste von Einheiten repräsentiert.

Weitere Beispiele und Optionen finden Sie unter Intl.ListFormat().

Relative Zeitformatierung

Intl.RelativeTimeFormat formatiert einen Zeitunterschied. Das RelativeTimeFormat-Objekt nimmt relative Zeiten in Form von zwei Argumenten: eine Zahl (mit beliebigem Vorzeichen) und eine Zeitöffnung, wie "day", "hour", oder "minute".

Es erledigt mehrere Dinge gleichzeitig:

• Es lokalisiert und pluralisiert die Zeitöffnung, wie "1 day" vs. "2 days", ähnlich wie bei der Zahlenformatierung.
• Es wählt die passende Phrase für vergangene und zukünftige Zeiten, wie "in 1 day" vs. "1 day ago".
• Es kann eine spezielle Phrase für einige Zeiteinheiten auswählen, wie "1 day ago" vs. "yesterday".

Weitere Beispiele und Optionen finden Sie unter Intl.RelativeTimeFormat().

Dauernformatierung

Intl.DurationFormat bietet die Formatierung von Dauern, wie "3 hours, 4 minutes, 5 seconds". Es ist keine primitive Operation mit eigenem Formatierer: Es verwendet intern Intl.NumberFormat und Intl.ListFormat, um jede Dauereinheit zu formatieren, und fügt sie dann mit einem Listentrenner zusammen. Das DurationFormat-Objekt nimmt Dauern in der Form eines Temporal.Duration-Objekts oder eines einfachen Objekts mit denselben Eigenschaften an.

Abgesehen von der Anpassung des Zahlensystems, entscheidet die Dauernformatierungs-Option, ob jede Komponente angezeigt wird und wie lang sie sein sollen.

Weitere Beispiele und Optionen finden Sie unter Intl.DurationFormat().

Kollation

Das Intl.Collator-Objekt ist nützlich zum Vergleichen und Sortieren von Strings. Es nimmt zwei Strings und gibt eine Zahl zurück, die ihre relative Ordnung angibt, auf die gleiche Weise wie das compareFn-Argument der Array.prototype.sort-Methode.

Es gibt viele Gründe, warum Sie keine JavaScript-Operatoren wie === oder > verwenden sollten, um benutzerorientierte Strings zu vergleichen:

• Irrelevante orthografische Varianten: Beispielsweise sollten im Englischen "naïve" und "naive" als alternative Schreibweisen desselben Wortes behandelt werden und gleich behandelt werden.
• Ignorieren die Großschreibung: Oft möchten Sie die Großschreibung beim Vergleich von Strings ignorieren. Beispielsweise sollten "apple" und "Apple" als gleich behandelt werden.
• Unicode-Codepunkt-Reihenfolge ergibt keinen Sinn: Vergleichsoperatoren wie > vergleichen anhand der Unicode-Codepunkt-Reihenfolge, die nicht dasselbe ist wie die Reihenfolge der Zeichen im Wörterbuch. Beispielsweise kommt "ï" nach "z" in Codepunktreihenfolge, aber man würde es im Wörterbuch neben "i" anordnen wollen.
• Unicode-Normalisierung: Dasselbe Zeichen kann in Unicode mehrere Darstellungen haben. Beispielsweise kann "ñ" als einzelnes Zeichen oder als "n" gefolgt von einem kombinierenden Tilde dargestellt werden (siehe String.prototype.normalize()). Diese sollten als gleich behandelt werden.
• Zahlenvergleich: Zahlen in Strings sollten als Zahlen verglichen werden und nicht als Strings. Beispielsweise möchte man, dass "test-10" nach "test-2" kommt.

Es gibt zwei unterschiedliche Anwendungsfälle für Kollation: Sortierung und Suche. Sortierung erfolgt, wenn Sie eine Liste von Strings haben und diese nach einer bestimmten Regel ordnen möchten. Suche erfolgt, wenn Sie eine Liste von Strings haben und einen String finden möchten, der einer Suchanfrage entspricht. Bei der Suche sollten Sie nur darauf achten, ob das Vergleichsergebnis Null (gleich) ist oder nicht, nicht auf das Vorzeichen des Ergebnisses.

Es gibt viele verschiedene Arten zu sortieren, sogar innerhalb derselben Locale. Beispielsweise gibt es im Deutschen zwei verschiedene Sortierreihenfolgen, Telefonbuch und Wörterbuch. Die Telefonbuchsortierung betont den Klang—als ob "ä", "ö" und so weiter auf "ae", "oe" und so weiter erweitert würden, bevor sie sortiert werden.

Einige deutsche Wörter konjugieren mit zusätzlichen Umlauten, sodass es in Wörterbüchern sinnvoll ist, die Umlaute zu ignorieren (außer beim Sortieren von Wörtern, die sich nur in Umlauten unterscheiden: schon vor schön).

Pluralregeln

Das Intl.PluralRules-Objekt ist nützlich, um die korrekte Pluralform eines Wortes auszuwählen. Es pluralisiert die Wörter nicht automatisch für Sie (zum Beispiel können Sie nicht "apple" übergeben und "apples" erwarten), aber es sagt Ihnen, welche Pluralform basierend auf einer Zahl verwendet werden soll. Sie tun dies möglicherweise bereits:

Aber dies ist schwer auf andere Sprachen zu verallgemeinern, insbesondere auf solche mit vielen Pluralformen. Sie können Intl.PluralRules für eine allgemeine Einführung in Pluralregeln einsehen. Hier demonstrieren wir einige gängige Anwendungsfälle.

Segmentierung

Das Intl.Segmenter-Objekt ist nützlich, um einen String in Segmente zu teilen. Ohne Intl können Sie bereits einen String durch UTF-16 Code-Einheiten und Unicode Code-Punkte teilen:

Aber wie Sie sehen können, sind Unicode-Code-Punkte nicht dasselbe wie das, was menschliche Nutzer als diskrete Zeichen wahrnehmen. Dies geschieht oft bei Emojis, wo ein einzelnes Emoji durch mehrere Code-Punkte dargestellt werden kann. Wenn der Nutzer mit Text arbeitet, ist ein Graphem die kleinste Einheit von Text, die sie manipulieren können, wie löschen oder auswählen. Das Segmenter-Objekt ermöglicht die Segmentierung auf Graphemebene, was nützlich ist zum Zählen von Zeichen, Messen der Textbreite und mehr. Es nimmt einen String und gibt ein iterierbares Segmente-Objekt zurück, wobei jedes Element eine segment-Eigenschaft hat, die den Text des Segments repräsentiert.

Der Segmentierer kann auch eine höhere Segmentierung durchführen, einschließlich der Segmentierung auf Wort- und Satzebene. Diese Anwendungsfälle sind notwendigerweise sprachspezifisch. Beispielsweise ist das folgende eine sehr schlechte Implementierung der Wortzählung:

Es gibt mehrere Probleme damit: nicht alle Sprachen verwenden Leerzeichen, um Wörter zu trennen, nicht alle Leerzeichen trennen Wörter, und nicht alle Wörter werden durch Leerzeichen getrennt. Um dies zu lösen, verwenden Sie Segmenter mit granularity: "word". Das Ergebnis ist der Eingabestring, getrennt in Segmente von Wörtern und Nicht-Wörtern. Wenn Sie Wörter zählen, sollten Sie die Nicht-Wörter herausfiltern, indem Sie die isWordLike-Eigenschaft jedes Segments überprüfen.

Die Wortsegmentierung funktioniert auch bei zeichenbasierten Sprachen. Beispielsweise können im Chinesischen mehrere Zeichen ein einziges Wort darstellen, aber es gibt keinen Leerraum dazwischen. Der Segmentierer implementiert dasselbe Verhalten wie die eingebaute Wortsegmentierung des Browsers, die durch Doppelklicken auf ein Wort ausgelöst wird.

Die Satzsegmentierung ist ähnlich komplex. Beispielsweise gibt es im Englischen viele Satzzeichen, die das Ende eines Satzes markieren könnten (".", "!", "?", und so weiter).

Beachten Sie, dass der Segmentierer keine Zeichen entfernt. Er teilt einfach den String in Segmente, von denen jedes einen Satz darstellt. Sie können dann die Satzzeichen entfernen, wenn Sie möchten. Auch die aktuelle Implementierung des Segmentierers unterstützt keine Satzsegmentierung-Unterdrückungen (Verhinderung von Satzumbrüchen nach Punkten wie "Mr." oder "Approx."), aber es wird daran gearbeitet, dies zu unterstützen.

Anzeigenamen

Nachdem so viele Optionen und Verhaltensweisen eingeführt wurden, fragen Sie sich möglicherweise, wie Sie diese dem Nutzer präsentieren können. Intl hat zwei nützliche APIs zum Aufbau von Benutzeroberflächen: Intl.supportedValuesOf() und Intl.DisplayNames.

Die Intl.supportedValuesOf()-Funktion gibt ein Array von unterstützten Werten für eine gegebene Option zurück. Beispielsweise können Sie dies verwenden, um eine Dropdown-Liste unterstützter Kalender zu füllen, aus der Benutzer auswählen können, um Daten anzuzeigen.

Diese Bezeichner sind jedoch oft nicht benutzerfreundlich. Beispielsweise möchten Sie möglicherweise die Kalender in der Sprache des Nutzers anzeigen oder sie unabgekürzt darstellen. Das Intl.DisplayNames-Objekt ist dafür nützlich. Es ist wie ein Formatierer, ist aber nicht schablonenbasiert. Stattdessen ist es eine direkte Zuordnung von sprachunabhängigen Bezeichnern zu lokalisierten Namen. Es unterstützt das Formatieren von Sprachen, Regionen, Schriften (die drei Unterfelder eines BCP 47 Sprach-Tags), Währung, Kalender und Datum-Zeit-Feldern.

Probieren Sie die untenstehende Demo aus:

• Zurück
• Weiter