String.prototype.toLocaleLowerCase()

toLocaleLowerCase() メソッドは、呼び出した文字列の値を、ロケールに依存した対応付けに基づいて小文字に変換して返します。

試してみましょう

構文

js
toLocaleLowerCase()
toLocaleLowerCase(locales)

引数

locales 省略可

BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。 ロケール固有の大文字小文字の対応付けに従って小文字に変換するために使用するロケールを示します。 引数 locales の一般的な形成と解釈については、Intl メインページの引数の説明 を参照してください。

引数 locales を使用する他のメソッドとは異なり、toLocaleLowerCase() はロケールの照合を許可しません。 そのため、引数 locales の有効性を調べた後、 toLocaleLowerCase() は常にリストの最初のロケール(リストが空の場合は既定値)を、そのロケールに実装で対応していない場合でも使用します。

返値

呼び出した文字列をロケールに依存した対応に基づいて小文字に変換したものを表す新しい文字列です。

解説

toLocaleLowerCase() メソッドは、ロケール固有の大文字小文字の対応付けに従って小文字に変換された文字列の値を返します。toLocaleLowerCase() はその文字列自体に影響を与えません。ほとんどの場合は toLowerCase() と同じ結果が得られますが、トルコ語のように大文字小文字のマッピングが Unicode 既定の大文字小文字のマッピングに従っていないロケールの場合は、異なる結果が得られる可能性があります。

toLocaleLowerCase() の使用

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

仕様書

Specification
ECMAScript Language Specification
# sec-string.prototype.tolocalelowercase
ECMAScript Internationalization API Specification
# sup-string.prototype.tolocalelowercase

ブラウザーの互換性

BCD tables only load in the browser

関連情報