String.prototype.toLocaleUpperCase()

Метод toLocaleUpperCase() (до вищого регістру згідно з локаллю) значень String повертає свій рядок, переведений у вищий регістр, із врахуванням будь-яких перетворень, специфічних для конкретної локалі.

Спробуйте його в дії

Синтаксис

toLocaleUpperCase()
toLocaleUpperCase(locales)

Параметри

locales Необов'язкове

Рядок з тегом мови BCP 47, або масив таких рядків. Позначає локаль, налаштування якої будуть використані для переведення рядка у верхній регістр, з урахуванням будь-яких специфічних для локалі перетворень. Загальну форму та тлумачення аргументу locales дивіться в описі цього параметра на головній сторінці Intl.

На відміну від інших методів, що використовують аргумент locales, toLocaleUpperCase() не дозволяє зіставлення локалей. Таким чином, перевіривши валідність аргументу locales, цей метод завжди використовує першу локаль у списку (або усталену локаль, якщо цей список порожній), навіть тоді, коли ця локаль не підтримується реалізацією.

Повернене значення

Новий рядок, що містить значення рядка, на якому було викликано метод, переведене у верхній регістр, з урахуванням будь-яких, специфічних для конкретної локалі, перетворень.

Опис

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

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

Приклади

Застосування toLocaleUpperCase()

"абетка".toLocaleUpperCase(); // 'АБЕТКА'

"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'

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

Сумісність із браузерами

Дивіться також

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