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 July 2015.

Die toLocaleUpperCase() Methode von String-Werten gibt diesen String in Großbuchstaben zurück, entsprechend lokalspezifischer Groß-/Kleinschreibungs-Mappings.

Probieren Sie es aus

const city = "istanbul";

console.log(city.toLocaleUpperCase("en-US"));
// Expected output: "ISTANBUL"

console.log(city.toLocaleUpperCase("TR"));
// Expected output: "İSTANBUL"

Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. Gibt die zu verwendende Lokale an, um Großbuchstaben entsprechend lokalspezifischer Mappings 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 toLocaleUpperCase() kein Lokale-Matching. Daher verwendet toLocaleUpperCase() nach Überprü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 darstellt, konvertiert in Großbuchstaben entsprechend lokalspezifischer Mappings.

Beschreibung

Die toLocaleUpperCase()-Methode gibt den Wert des Strings zurück, konvertiert in Großbuchstaben entsprechend lokalspezifischer Mappings. toLocaleUpperCase() beeinflusst den Wert des Strings selbst nicht. In den meisten Fällen wird dies das gleiche Ergebnis wie toUpperCase() produzieren, aber für einige Lokalisierungen, wie z.B. Türkisch, deren Groß-/Kleinschreibungs-Mappings nicht den Standards in Unicode folgen, kann es ein anderes Ergebnis geben.

Beachten Sie auch, dass die Konvertierung nicht zwingend eine 1:1-Zeichenabbildung ist, da einige Zeichen in zwei (oder sogar mehr) Zeichen umgewandelt werden können, wenn sie in Großbuchstaben umgewandelt werden. Daher kann die Länge des Ergebnis-Strings von der Eingabelänge abweichen. Dies impliziert auch, dass die Konvertierung nicht stabil ist, sodass beispielsweise folgendes 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® 2026 Language Specification # sec-string.prototype.tolocaleuppercase
ECMAScript® 2026 Internationalization API Specification # sup-string.prototype.tolocaleuppercase

String.prototype.toLocaleUpperCase()

Probieren Sie es aus

Syntax

Parameter