String.prototype.toLocaleUpperCase()

Baseline Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в версиях браузеров. Она доступна во всех браузерах с сентября 2017 года.

Метод toLocaleUpperCase() объекта String возвращает строку, преобразованную в верхний регистр, в соответствии с правилами преобразования регистра для указанной локали.

Попробуйте

const city = "istanbul";

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

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

Синтаксис

toLocaleUpperCase()
toLocaleUpperCase(locales)

Параметры

locales Необязательный

Строка с языковым тегом BCP 47 или массив таких строк. Указывает локаль, которая должна использоваться для преобразования в верхний регистр в соответствии с правилами преобразования регистра для конкретной локали. Общую форму и интерпретацию аргумента locales см. в описании параметра на главной странице Intl.

В отличие от других методов, использующих аргумент locales, toLocaleUpperCase() не допускает сопоставление локалей. Поэтому после проверки корректности аргумента locales, toLocaleUpperCase() всегда использует первую локаль из списка (или локаль по умолчанию, если список пуст), даже если эта локаль не поддерживается реализацией.

Возвращаемое значение

Новая строка, представляющая исходную строку, преобразованную в верхний регистр, в соответствии с правилами преобразования регистра для указанной локали.

Описание

Метод toLocaleUpperCase() возвращает значение строки, преобразованное в верхний регистр в соответствии с правилами преобразования регистра для конкретной локали. toLocaleUpperCase() не изменяет значение самой строки. В большинстве случаев это даст тот же результат, что и toUpperCase(), но для некоторых локалей, например турецкой, правила преобразования регистра которой отличаются от стандартных правил Unicode, результат может быть другим.

Также следует учитывать, что преобразование не обязательно является отображением символов 1:1, так как некоторые символы могут превращаться в два (или даже более) символа при преобразовании в верхний регистр. Следовательно, длина результирующей строки может отличаться от исходной. Это также означает, что преобразование не является стабильным, поэтому, например, следующее может вернуть false: x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

Примеры

Использование 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'

Спецификации

Спецификация
Языковая спецификация ECMAScript® 2027 # sec-string.prototype.tolocaleuppercase
Спецификация API интернационализации ECMAScript® 2027 # sup-string.prototype.tolocaleuppercase

Совместимость с браузерами

	Настольные компьютеры					Мобильные устройства							Сервер
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`toLocaleUpperCase`	1	12	1	4	1.3	18	4	10.1	1	1.0	4.4	1	1.0.0	1.0	0.10.0
`locales_parameter`	58	12	55	45	10	58	55	42	10	7.0	58	10	1.0.0	1.8 1.0–1.8 Доступны только данные локали для `en-US`.	13.0.0 0.12.0–13.0.0 До версии 13.0.0 по умолчанию доступны только данные локали для `en-US`. При указании других локалей функция молчаливо переключается на `en-US`. Чтобы сделать полные данные ICU (локальные) доступными до версии 13, см. документацию Node.js по опции `--with-intl` и о том, как предоставить данные.

См. также

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLocaleUpperCase