String.prototype.toLocaleUpperCase()

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

構文

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

引数

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

戻り値

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

例外

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

説明

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

また、幾つかの文字は大文字に変換した際に 2 つの(あるいはそれ以上)の文字になる可能性があるため、変換は必ずしも 1:1 のキャラクターマッピングではないことにも注意してください。それゆえ、結果の文字列の長さは、入力文字列の長さと異なることがありえます。これはまた、変換は不変ではないことを意味し、以下のコードは false を返します:x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

例: toLocaleUpperCase()を使う

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

'Gesäß'.toLocaleUpperCase(); // 'GESÄSS'

'i\u0307'.toLocaleUpperCase('lt-LT'); // 'I'

let locales = ['lt', 'LT', 'lt-LT', 'lt-u-co-phonebk', 'lt-x-lietuva'];
'i\u0307'.toLocaleUpperCase(locales); // 'I'

仕様

仕様 状況 コメント
ECMAScript 3rd Edition. Standard Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
String.prototype.toLocaleUpperCase の定義
標準
ECMAScript 2015 (6th Edition, ECMA-262)
String.prototype.toLocaleUpperCase の定義
標準
ECMAScript Latest Draft (ECMA-262)
String.prototype.toLocaleUpperCase の定義
ドラフト
ECMAScript Internationalization API 4.0 (ECMA-402)
String.prototype.toLocaleUpperCase の定義
ドラフト ES Intl 2017 added the localeparameter.

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
toLocaleUpperCaseChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 5.5Opera 完全対応 4Safari 完全対応 1.3WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 あり
localeChrome 完全対応 58Edge 完全対応 12Firefox 完全対応 55IE 完全対応 6Opera 完全対応 45Safari 完全対応 10WebView Android 完全対応 58Chrome Android 完全対応 58Firefox Android 完全対応 55Opera Android 完全対応 42Safari iOS 完全対応 10Samsung Internet Android 完全対応 7.0nodejs ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明

関連情報