String.prototype.toLocaleLowerCase()

toLocaleLowerCase() メソッドは任意のロケール固有のケースマッピングに従って、参照文字列の値を小文字に変換して返します。

構文

str.toLocaleLowerCase()
str.toLocaleLowerCase(locale) 
str.toLocaleLowerCase([locale, locale, ...])

引数

locale Optional
locale 引数はロケール固有のケースマッピングに従って小文字に変換するのに使用するロケールを示します。配列の中で複数のロケールが指定された場合、best available locale が使用されます。デフォルト値はホスト環境の実行中のロケールです。

戻り値

任意のロケール固有のケースマッピングに従い小文字に変換された、メソッドを呼び出している文字列に対応する新しい文字列。 

例外

  • RangeError ("無効な language タグ: xx_yy") は、locale 引数が有効なlanguageタグではない場合に投げられる。
  • TypeError ("ロケール引数中の無効な要素")  は、配列の要素が type 文字列ではない場合に投げられる。

説明

toLocaleLowerCase() メソッドは任意のロケール固有のケースマッピングに従って小文字に変換された文字列の値を返します。toLocaleLowerCase()は文字列自体の値には影響を与えません。ほとんどの場合に、toLowerCase()と同じ結果になりますが、トルコ語のような、Unicodeのデフォルトケースマッピングに従わないケースマッピングの一部のローケルに対して、違った結果になるかもしれません。

例: toLocaleLowerCase()を使う

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

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

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

仕様

仕様 状況 コメント
ECMAScript 3rd Edition. Standard Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
String.prototype.toLocaleLowerCase の定義
標準
ECMAScript 2015 (6th Edition, ECMA-262)
String.prototype.toLocaleLowerCase の定義
標準
ECMAScript (ECMA-262)
String.prototype.toLocaleLowerCase の定義
現行の標準
ECMAScript Internationalization API (ECMA-402)
String.prototype.toLocaleLowerCase の定義
現行の標準 ES Intl 2017 added the locale parameter.

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
toLocaleLowerCaseChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 5.5Opera 完全対応 4Safari 完全対応 1.3WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.1.100
localeChrome 完全対応 58Edge 完全対応 12Firefox 完全対応 55IE 完全対応 6Opera 完全対応 45Safari 完全対応 10WebView Android 完全対応 58Chrome Android 完全対応 58Firefox Android 完全対応 55Opera Android 完全対応 43Safari iOS 完全対応 10Samsung Internet Android 完全対応 7.0nodejs 完全対応 13.0.0
完全対応 13.0.0
部分対応 0.12
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. When other locales are specified, the function silently falls back to en-US. To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.

凡例

完全対応  
完全対応
実装ノートを参照してください。
実装ノートを参照してください。

関連情報