String.prototype.toLocaleUpperCase()

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 toLocaleUpperCase()-Methode von String-Werten gibt diesen String in Großbuchstaben umgewandelt zurück, entsprechend den lokalspezifischen Großbuchstabenabbildungen.

Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Gibt die zu verwendende Lokale an, um in Großbuchstaben umzuwandeln, entsprechend lokalspezifischer Großbuchstabenabbildungen. Für die allgemeine Form und Interpretation des locales Arguments siehe die Parameterbeschreibung auf der Intl Hauptseite.

Im Gegensatz zu anderen Methoden, die das locales-Argument verwenden, erlaubt toLocaleUpperCase() kein Lokale-Matching. Daher verwendet toLocaleUpperCase(), nachdem die Gültigkeit des locales-Arguments überprüft wurde, immer die erste Lokale in der Liste (oder die Standardlokale, 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, der gemäß lokalspezifischen Großbuchstabenabbildungen in Großbuchstaben umgewandelt wurde.

Beschreibung

Die toLocaleUpperCase()-Methode gibt den Wert des Strings zurück, umgewandelt in Großbuchstaben gemäß lokalspezifischer Großbuchstabenabbildungen. toLocaleUpperCase() beeinflusst nicht den Wert des Strings selbst. In den meisten Fällen wird dies das gleiche Ergebnis wie toUpperCase() produzieren, aber für einige Lokale, wie etwa Türkisch, deren Großbuchstabenabbildungen nicht den Standardabbildungen in Unicode folgen, kann es ein anderes Ergebnis geben.

Beachten Sie auch, dass die Umwandlung nicht unbedingt eine 1:1-Zeichenabbildung ist, da einige Zeichen bei der Umwandlung in Großbuchstaben zu zwei (oder sogar mehr) Zeichen führen können. Daher kann sich die Länge des Ergebnisstrings von der Eingabelänge unterscheiden. Dies impliziert auch, dass die Umwandlung nicht stabil ist, sodass zum Beispiel das folgende false zurückgeben kann: x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

Beispiele

Verwendung von toLocaleUpperCase()

"alphabet".toLocaleUpperCase(); // 'ALPHABET'

"Gesäß".toLocaleUpperCase(); // 'GESÄSS'

"i\u0307".toLocaleUpperCase("lt-LT"); // 'I'

const locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"];
"i\u0307".toLocaleUpperCase(locales); // 'I'

Spezifikationen

Specification
ECMAScript® 2025 Language Specification # sec-string.prototype.tolocaleuppercase
ECMAScript® 2025 Internationalization API Specification # sup-string.prototype.tolocaleuppercase

Browser-Kompatibilität

BCD tables only load in the browser

String.prototype.toLocaleUpperCase()

Probieren Sie es aus

Syntax

Parameter