String.prototype.toLocaleUpperCase()

Probieren Sie es aus

const city = "istanbul";

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

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

Syntax

toLocaleUpperCase()
toLocaleUpperCase(locales)

Parameter

locales Optional

Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. Gibt die Lokalisation an, die für die Umwandlung in Großbuchstaben gemäß jeglichen lokalspezifischen Groß-/Kleinschreibungsmapping verwendet werden soll. 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 Lokalisierungs-Matching. Daher verwendet toLocaleUpperCase() nach Überprüfung der Gültigkeit des locales-Arguments immer die erste Lokalisierung in der Liste (oder die Standardlokalisierung, falls die Liste leer ist), selbst wenn diese Lokalisierung von der Implementierung nicht unterstützt wird.

Rückgabewert

Ein neuer String, der den aufrufenden String in Großbuchstaben konvertiert darstellt, gemäß jeglichen lokalspezifischen Groß-/Kleinschreibungsmapping.

Beschreibung

Die Methode toLocaleUpperCase() gibt den Wert der Zeichenkette zurück, die gemäß jeglichen lokalspezifischen Groß-/Kleinschreibungsmapping in Großbuchstaben konvertiert wurde. toLocaleUpperCase() beeinflusst nicht den Wert der Zeichenkette selbst. In den meisten Fällen wird dies dasselbe Ergebnis wie toUpperCase() liefern, aber für einige Lokalisierungen, wie zum Beispiel Türkisch, deren Groß-/Kleinschreibungsmapping nicht den Standard-Unicode-Zuordnungen folgt, kann es ein unterschiedliches Ergebnis geben.

Es sei auch darauf hingewiesen, dass die Konvertierung nicht unbedingt eine 1:1-Zeichen-Mapping ist, da einige Zeichen bei der Umwandlung in Großbuchstaben zu zwei (oder noch mehr) Zeichen führen können. Daher kann sich die Länge der Ergebniszeichenkette von der Eingabelänge unterscheiden. Dies bedeutet 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

Browser-Kompatibilität

Siehe auch

• String.prototype.toLocaleLowerCase()
• String.prototype.toLowerCase()
• String.prototype.toUpperCase()