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

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.

ブラウザ実装状況

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,