Intl.Locale.prototype.numeric
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.
Die numeric-Accessor-Eigenschaft von Intl.Locale-Instanzen gibt an, ob für dieses Gebietsschema bei der Sortierung numerische Zeichen besonders behandelt werden.
Beschreibung
Wie caseFirst stellt numeric eine Änderung der Sortierregeln des Gebietsschemas dar. numeric ist ein boolescher Wert und kann daher entweder true oder false sein. Wenn numeric auf false gesetzt ist, werden numerische Werte in Zeichenfolgen nicht besonders behandelt. Wenn numeric auf true gesetzt ist, berücksichtigt das Gebietsschema numerische Zeichen beim Sortieren von Zeichenfolgen. Diese besondere Behandlung bedeutet, dass Folgen von Dezimalziffern als Zahlen verglichen werden. Beispielsweise gilt die Zeichenfolge „A-21“ als kleiner als „A-123“.
Der Wert der Eigenschaft numeric wird bei der Erstellung festgelegt: entweder über den Schlüssel kn im Gebietsschema-Bezeichner oder über die Option numeric des Konstruktors Intl.Locale(). Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner der beiden angegeben, hat die Eigenschaft den Wert false.
Der Set-Accessor von numeric ist undefined. Sie können diese Eigenschaft nicht direkt ändern.
Beispiele
Wie andere Gebietsschema-Subtags kann der Wert für numeric dem Intl.Locale-Objekt über die Gebietsschema-Zeichenfolge oder über ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.
Einen numeric-Wert über die Gebietsschema-Zeichenfolge hinzufügen
In der Spezifikation für Unicode-Gebietsschema-Zeichenfolgen ist numeric ein „Erweiterungs-Subtag“. Solche Subtags enthalten zusätzliche Angaben zum Gebietsschema und werden Gebietsschema-Bezeichnern mithilfe des Erweiterungsschlüssels -u hinzugefügt. Um der anfänglichen Gebietsschema-Zeichenfolge, die an den Konstruktor Intl.Locale() übergeben wird, einen Wert für numeric hinzuzufügen, fügen Sie zunächst den Erweiterungsschlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie anschließend die Erweiterung -kn hinzu, um anzugeben, dass Sie einen Wert für numeric hinzufügen. Geben Sie zum Schluss den Wert für numeric an. Wenn Sie numeric auf true setzen möchten, genügt es, den Schlüssel kn hinzuzufügen. Um den Wert auf false zu setzen, müssen Sie nach dem Schlüssel kn ausdrücklich "false" angeben.
const locale = new Intl.Locale("fr-Latn-FR-u-kn-false");
console.log(locale.numeric); // false
Einen numeric-Wert über das Konfigurationsobjekt hinzufügen
Der Konstruktor Intl.Locale() akzeptiert ein optionales Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungstypen enthalten, darunter numeric. Setzen Sie die Eigenschaft numeric des Konfigurationsobjekts auf den gewünschten Wert für numeric und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("en-Latn-US", { numeric: true });
console.log(locale.numeric); // true
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.numeric> |