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 von String-Werten gibt diese Zeichenfolge in Kleinbuchstaben umgewandelt zurück, entsprechend lokalspezifischer Fallunterscheidungen.

Probieren Sie es aus

Syntax

js
toLocaleLowerCase()
toLocaleLowerCase(locales)

Parameter

locales Optional

Ein String mit einem BCP 47-Sprach-Tag oder ein Array solcher Strings. Gibt die zu verwendende Locale an, um in Kleinbuchstaben gemäß lokalspezifischen Fallunterscheidungen zu konvertieren. Für die allgemeine Form und Interpretation des locales Arguments siehe die Parameterbeschreibung auf der Intl Hauptseite.

Anders als bei anderen Methoden, die das locales Argument verwenden, erlaubt toLocaleLowerCase() keinen Locale-Abgleich. Daher verwendet toLocaleLowerCase() nach Prüfung der Gültigkeit des locales Arguments immer die erste Locale in der Liste (oder die Standard-Locale, wenn die Liste leer ist), selbst wenn diese Locale von der Implementierung nicht unterstützt wird.

Rückgabewert

Ein neuer String, der den aufrufenden String in Kleinbuchstaben umgewandelt darstellt, gemäß lokalspezifischen Fallunterscheidungen.

Beschreibung

Die toLocaleLowerCase()-Methode gibt den Wert der Zeichenfolge in Kleinbuchstaben umgewandelt zurück, entsprechend lokalspezifischen Fallunterscheidungen. toLocaleLowerCase() beeinflusst nicht den Wert der Zeichenfolge selbst. In den meisten Fällen wird dies dasselbe Ergebnis wie toLowerCase() liefern, aber für einige Locales, wie etwa Türkisch, deren Fallunterscheidungen nicht den Standard-Fallunterscheidungen in Unicode folgen, kann es ein anderes Ergebnis geben.

Beispiele

Verwendung von toLocaleLowerCase()

js
"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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch