String.prototype.toLocaleLowerCase()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die toLocaleLowerCase() Methode von String-Werten gibt diesen String in Kleinbuchstaben zurück, gemäß sämtlichen lokalespezifischen Fallunterscheidungen.
Probieren Sie es aus
const dotted = "İstanbul";
console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "i̇stanbul"
console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "istanbul"
Syntax
toLocaleLowerCase()
toLocaleLowerCase(locales)
Parameter
localesOptional-
Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. Gibt die zu verwendende Lokale an, um gemäß allen lokalespezifischen Fallunterscheidungen in Kleinbuchstaben umgewandelt zu werden. Für die allgemeine Form und Interpretation des
locales-Arguments, siehe die Parameterbeschreibung auf derIntlHauptseite.Im Gegensatz zu anderen Methoden, die das
locales-Argument verwenden, erlaubttoLocaleLowerCase()kein Lokale-Matching. Daher wird nach Überprüfung der Gültigkeit deslocales-Arguments vontoLocaleLowerCase()immer die erste Lokale in der Liste verwendet (oder die Standard-Lokale, wenn die Liste leer ist), selbst wenn diese Lokale von der Implementierung nicht unterstützt wird.
Rückgabewert
Ein neuer String, der den aufrufenden String darstellt, umgewandelt in Kleinbuchstaben gemäß sämtlichen lokalespezifischen Fallunterscheidungen.
Beschreibung
Die toLocaleLowerCase()-Methode gibt den Wert des Strings zurück, umgewandelt in Kleinbuchstaben gemäß allen lokalespezifischen Fallunterscheidungen.
toLocaleLowerCase() beeinflusst nicht den Wert des Strings selbst. In den meisten Fällen wird dies das gleiche Ergebnis wie toLowerCase() liefern, aber für einige Lokales, wie die türkische, deren Fallunterscheidungen nicht den Standard-Fallunterscheidungen in Unicode folgen, kann es ein unterschiedliches Ergebnis geben.
Beispiele
Verwendung von toLocaleLowerCase()
"ALPHABET".toLocaleLowerCase(); // 'alphabet'
"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false
const locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"];
"\u0130".toLocaleLowerCase(locales) === "i"; // true
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.tolocalelowercase |
| ECMAScript® 2026 Internationalization API Specification # sup-string.prototype.tolocalelowercase |