JavaScript метод toLocaleUpperCase()

JavaScript String

Определение и применение

JavaScript метод toLocaleUpperCase() преобразует строку в заглавные буквы (верхний регистр) с учетом текущего языкового стандарта. Для того, чтобы преобразовать строку в строчные буквы (нижний регистр) с учетом текущего языкового стандарта вы можете воспользоваться методом toLocaleLowerCase().


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


Поддержка браузерами

Метод toLocaleUpperCase()Chrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
Базовая поддержкаДаДаДаДаДаДа
Параметр locales (ES 2017 Draft)?55.0????

JavaScript синтаксис:

// используя текущий языковой стандарт
str.toLocaleUpperString();

// используя указанный языковой стандарт
str.toLocaleUpperString( locales );
str.toLocaleUpperString( [locales, ..., locales]);

Версия JavaScript

ECMAScript 3rd Edition (Реализовано в JavaScript 1.2)

Значения параметров

ПараметрОписание
localesПараметр должен быть строкой, содержащей языковой тег BCP 47, или массивом таких языковых тегов. Если параметр не указан или не определен, используется языковой стандарт среды выполнения JavaScript по умолчанию. При указании нескольких строк языкового стандарта следует перечислять их в порядке убывания приоритета, чтобы первая запись была предпочитаемым языковым стандартом. Необязательный параметр.
Языковой тег BCP 47 определяет язык и минимально содержит код основного языка. В своем наиболее распространенном виде он может содержать по порядку: код языка, код скрипта и код страны или региона, разделенные дефисами. Хотя тег не чувствителен к регистру, рекомендуется использовать заглавные буквы для кода скрипта, верхний регистр для кода страны и региона, а строчный регистр для всего остального.

Исключения

Тип исключенияОписание
RangeErrorВозникает в том случае, если параметр locales содержит недопустимый языковой тег.
TypeErrorВозникает в том случае, если параметр locales содержит массив, значение которого не соответствует строке или объекту.

Пример использования

var str = "crocodile", // инициализируем строковые переменные
    str2 =  "1a2b3c"; 

str.toLocaleUpperCase(); // возвращаемое значение "CROCODILE"
str.toLocaleUpperCase( "en-US" ); // возвращаемое значение "crocodile"

str2.toLocaleUpperCase(); // возвращаемое значение "1A2B3C"
str2.toLocaleUpperCase( "en-US" ); // возвращаемое значение "1A2B3C"

str2.toLocaleUpperCase( "2" ); // RangeError
str2.toLocaleUpperCase( ["ru-RU", "en-US"] ); // возвращаемое значение "1A2B3C"
str2.toLocaleUpperCase( ["ru-RU", 2] ); // TypeError
JavaScript String