この翻訳は不完全です。英語から この記事を翻訳 してください。

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 Latest Draft (ECMA-262)
String.prototype.toLocaleLowerCase の定義
ドラフト  
ECMAScript Internationalization API 4.0 (ECMA-402)
String.prototype.toLocaleLowerCase の定義
ドラフト ES Intl 2017 added the locale parameter.

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) (有) (有) (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

このページの貢献者: stkntr, shide55
最終更新者: stkntr,