String.prototype.toLocaleLowerCase()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode toLocaleLowerCase() von String-Werten gibt diesen String in Kleinbuchstaben umgewandelt zurück. Dabei werden gebietsschemaspezifische Regeln zur Groß- und Kleinschreibung berücksichtigt.
Probieren Sie es aus
const dotted = "İstanbul";
console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "EN-US: i̇stanbul"
console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "TR: istanbul"
Syntax
toLocaleLowerCase()
toLocaleLowerCase(locales)
Parameter
localesOptional-
Ein String mit einem BCP-47-Sprachtag oder ein Array solcher Strings. Gibt das Gebietsschema an, das bei der Umwandlung in Kleinbuchstaben gemäß gebietsschemaspezifischen Regeln zur Groß- und Kleinschreibung verwendet werden soll. Allgemeine Informationen zur Form und Interpretation des Arguments
localesfinden Sie in der Beschreibung des Parameters auf derIntl-Hauptseite.Anders als andere Methoden, die das Argument
localesverwenden, führttoLocaleLowerCase()keinen Abgleich mit unterstützten Gebietsschemas durch. Nach der Prüfung der Gültigkeit des ArgumentslocalesverwendettoLocaleLowerCase()daher immer das erste Gebietsschema in der Liste (oder das Standardgebietsschema, wenn die Liste leer ist) – auch wenn die Implementierung dieses Gebietsschema nicht unterstützt.
Rückgabewert
Ein neuer String, der den aufrufenden String in Kleinbuchstaben umgewandelt darstellt. Dabei werden gebietsschemaspezifische Regeln zur Groß- und Kleinschreibung berücksichtigt.
Beschreibung
Die Methode toLocaleLowerCase() gibt den Wert des Strings in Kleinbuchstaben umgewandelt zurück und berücksichtigt dabei gebietsschemaspezifische Regeln zur Groß- und Kleinschreibung. toLocaleLowerCase() verändert den Wert des Strings selbst nicht. In den meisten Fällen ist das Ergebnis dasselbe wie bei toLowerCase(). Für einige Gebietsschemas, etwa Türkisch, deren Regeln zur Groß- und Kleinschreibung von den Standardregeln in Unicode abweichen, kann das Ergebnis jedoch anders ausfallen.
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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.tolocalelowercase |
| ECMAScript® 2027 Internationalization API Specification # sup-string.prototype.tolocalelowercase |