String.prototype.toLocaleLowerCase()

Базовый уровень Широко доступно

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

Метод toLocaleLowerCase() значений String возвращает эту строку, преобразованную в нижний регистр в соответствии с любыми зависящими от локали правилами преобразования регистра.

Попробовать

const dotted = "İstanbul";

console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "i̇stanbul"

console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "istanbul"

Синтаксис

toLocaleLowerCase()
toLocaleLowerCase(locales)

Параметры

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

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

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

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

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

Описание

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

Примеры

Использование toLocaleLowerCase()

"ALPHABET".toLocaleLowerCase(); // 'alphabet'

"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false

const locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"];
"\u0130".toLocaleLowerCase(locales) === "i"; // true

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

Спецификация
ECMAScript® 2027 Language Specification # sec-string.prototype.tolocalelowercase
ECMAScript® 2027 Internationalization API Specification # sup-string.prototype.tolocalelowercase

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

	Десктопные					Мобильные							Серверные
	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
`toLocaleLowerCase`	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	43	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/toLocaleLowerCase