Intl.Collator - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Intl.Collator

Baseline Weitgehend verfügbar

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

Das Intl.Collator-Objekt ermöglicht einen sprachsensitiven String-Vergleich.

In diesem Artikel

Probieren Sie es aus

console.log(["Z", "a", "z", "ä"].sort(new Intl.Collator("de").compare));
// Expected output: Array ["a", "ä", "z", "Z"]

console.log(["Z", "a", "z", "ä"].sort(new Intl.Collator("sv").compare));
// Expected output: Array ["a", "z", "Z", "ä"]

console.log(
  ["Z", "a", "z", "ä"].sort(
    new Intl.Collator("de", { caseFirst: "upper" }).compare,
  ),
);
// Expected output: Array ["a", "ä", "Z", "z"]

Konstruktor

Intl.Collator()

Erstellt ein neues Collator-Objekt.

Statische Methoden

Intl.Collator.supportedLocalesOf()

Gibt ein Array zurück, das diejenigen der bereitgestellten Lokalwerte enthält, die ohne Rückgriff auf die Standardlokale der Laufzeitumgebung unterstützt werden.

Instanzeigenschaften

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

Intl.Collator.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für Intl.Collator-Instanzen ist der Anfangswert der Intl.Collator-Konstruktor.

Intl.Collator.prototype[Symbol.toStringTag]

Der anfängliche Wert der [Symbol.toStringTag]-Eigenschaft ist der String "Intl.Collator". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanzmethoden

Intl.Collator.prototype.compare()

Getter-Funktion, die zwei Strings gemäß der Sortierreihenfolge dieses Intl.Collator-Objekts vergleicht.

Intl.Collator.prototype.resolvedOptions()

Gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung des Objekts berechneten Lokale und Kollationsoptionen widerspiegeln.

Beispiele

Verwendung von Collator

Das folgende Beispiel zeigt die unterschiedlichen potenziellen Ergebnisse für einen String, der vor, nach oder auf der gleichen Ebene wie ein anderer auftritt:

js
console.log(new Intl.Collator().compare("a", "c")); // -1, or some other negative value
console.log(new Intl.Collator().compare("c", "a")); // 1, or some other positive value
console.log(new Intl.Collator().compare("a", "a")); // 0

Beachten Sie, dass die im obigen Code gezeigten Ergebnisse zwischen Browsern und Browserversionen variieren können. Das liegt daran, dass die Werte implementierungsspezifisch sind. Die Spezifikation verlangt nur, dass die Vorher- und Nachher-Werte negativ bzw. positiv sind.

Verwendung von Lokalwerten

Die von Intl.Collator.prototype.compare() bereitgestellten Ergebnisse variieren zwischen Sprachen. Um die Sortierreihenfolge der in der Benutzeroberfläche Ihrer Anwendung verwendeten Sprache zu erhalten, geben Sie diese Sprache (und möglicherweise einige Rückfallsprachen) mit dem locales-Argument an:

js
// in German, ä sorts with a
console.log(new Intl.Collator("de").compare("ä", "z"));
// -1, or some other negative value

// in Swedish, ä sorts after z
console.log(new Intl.Collator("sv").compare("ä", "z"));
// 1, or some other positive value

Verwendung von Optionen

Die von Intl.Collator.prototype.compare() bereitgestellten Ergebnisse können mit dem options-Argument angepasst werden:

js
// in German, ä has a as the base letter
console.log(new Intl.Collator("de", { sensitivity: "base" }).compare("ä", "a"));
// 0

// in Swedish, ä and a are separate base letters
console.log(new Intl.Collator("sv", { sensitivity: "base" }).compare("ä", "a"));
// 1, or some other positive value

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

Standard eingebaute Objekte
Intl.Collator
Konstruktor
1. Intl.Collator()
Statische Methoden
1. supportedLocalesOf()
Instanzmethoden
1. compare()
2. resolvedOptions()
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.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.ListFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter