JavaScript

：

：

String.prototype.toLocaleLowerCase()メソッド

　編集：2022.08.16 by T.A.

→

その文字列を、ロケールに基づいて小文字に変換して返します。

構文
string= String.toLocaleLowerCase()
string= String.toLocaleLowerCase(locale)
string= String.toLocaleLowerCase( [locale, locale, ...] )
String String。
locale 省略可。locale 引数は、ロケールに依存した対応に基づいた小文字への変換に使用されるロケールを示します。

複数のロケールが Array で与えられた場合は、利用可能な最良のロケールが使用されます。

既定のロケールはホスト環境の現在のロケールです。

戻り値

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

例外
RangeError（"invalid language tag: xx_yy"）
locale 引数が妥当な言語タグでない場合に発生します。
TypeError（"invalid element in locales argument"）
配列の要素が文字列型でなかった場合に発生します。
解説

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

例
D='ALPHABET'.toLocaleLowerCase(); //＝'alphabet'

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

let locales = ['tr', 'TR', 'tr-TR', 'tr-u-co-search', 'tr-x-turkish'];
D='\u0130'.toLocaleLowerCase(locales) === 'i'; //＝true
関連

toLocaleLowerCase()、toLocaleUpperCase()。

toLowerCase()、toUpperCase()。

テスト