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 September 2017.
Die toLocaleLowerCase() Methode der String Werte gibt diesen String in Kleinbuchstaben zurück, gemäß den sprachspezifischen Zeichensatzkonvertierungen.
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 Sprach-Tag oder ein Array solcher Strings. Gibt die zu verwendende Locale an, um gemäß den sprachspezifischen Zeichensatzkonvertierungen in Kleinbuchstaben umzuwandeln. Für die allgemeine Form und Interpretation des
localesArguments siehe die Parameterbeschreibung auf der Hauptseite vonIntl.Im Gegensatz zu anderen Methoden, die das
localesArgument verwenden, erlaubttoLocaleLowerCase()kein Locale-Matching. Daher verwendettoLocaleLowerCase()nach der Überprüfung der Gültigkeit deslocalesArguments immer das erste Locale in der Liste (oder das Standard-Locale, wenn die Liste leer ist), auch wenn dieses Locale von der Implementierung nicht unterstützt wird.
Rückgabewert
Ein neuer String, der den aufrufenden String in Kleinbuchstaben konvertiert darstellt, gemäß den sprachspezifischen Zeichensatzkonvertierungen.
Beschreibung
Die toLocaleLowerCase() Methode gibt den Wert des Strings zurück, der in Kleinbuchstaben konvertiert wurde, gemäß den sprachspezifischen Zeichensatzkonvertierungen. toLocaleLowerCase() beeinflusst nicht den Wert des Strings selbst. In den meisten Fällen wird dies dasselbe Ergebnis liefern wie toLowerCase(), aber für einige Locales, wie das Türkische, deren Zeichensatzkonvertierungen nicht den Standard-Zeichensatzkonvertierungen in Unicode folgen, kann es zu einem abweichenden Ergebnis kommen.
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® 2025 Language Specification # sec-string.prototype.tolocalelowercase |
| ECMAScript® 2025 Internationalization API Specification # sup-string.prototype.tolocalelowercase |