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 diese Zeichenfolge in Kleinbuchstaben zurück, entsprechend den lokalespezifischen Groß- und Kleinschreibungszuordnungen.
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
locales
Optional-
Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. Gibt die zu verwendende Locale an, um in Kleinbuchstaben zu konvertieren, entsprechend den lokalespezifischen Groß- und Kleinschreibungszuordnungen. Für die allgemeine Form und Interpretation des
locales
-Arguments siehe die Parameterbeschreibung auf derIntl
-Hauptseite.Anders als andere Methoden, die das
locales
-Argument verwenden, erlaubttoLocaleLowerCase()
kein Locale-Matching. Daher verwendettoLocaleLowerCase()
nach Überprüfung der Gültigkeit deslocales
-Arguments immer die erste Locale in der Liste (oder die Standard-Locale, wenn die Liste leer ist), selbst wenn diese Locale nicht durch die Implementierung unterstützt wird.
Rückgabewert
Ein neuer String, der die aufrufende Zeichenfolge in Kleinbuchstaben konvertiert darstellt, entsprechend den lokalespezifischen Groß- und Kleinschreibungszuordnungen.
Beschreibung
Die toLocaleLowerCase()
-Methode gibt den Wert der Zeichenfolge zurück, der in Kleinbuchstaben konvertiert wurde, entsprechend den lokalespezifischen Groß- und Kleinschreibungszuordnungen.
toLocaleLowerCase()
beeinflusst den Wert der Zeichenfolge selbst nicht. In den meisten Fällen wird dies dasselbe Ergebnis liefern wie toLowerCase()
, aber für einige Locales, wie z.B. Türkisch, deren Groß- und Kleinschreibungszuordnungen nicht den Standard-Zuordnungen 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 |