Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】TypedArray::TypedArray.prototype.toLocaleStringインスタンスメソッドの使い方

TypedArray.prototype.toLocaleString()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

TypedArray.prototype.toLocaleString()メソッドは、TypedArrayオブジェクトの各要素を、現在のロケールまたは指定されたロケールに応じた書式設定の文字列に変換して返すメソッドです。これは、TypedArrayの数値を、ユーザーの地域や言語の慣習に合わせた読みやすい形式で表示するのに役立ちます。例えば、数値の小数点記号や桁区切り記号が、閲覧者の地域設定に合わせて調整されます。

引数として、オプションでlocalesとoptionsを指定できます。locales引数には、書式設定に用いる言語や地域の識別子(例: 'en-US'、'ja-JP')を文字列または文字列の配列で指定します。options引数には、数値の表示形式(例: 小数点以下の桁数、通貨表示)に関する詳細設定を含むオブジェクトを渡すことで、変換の動作を細かく制御できます。

TypedArrayの各要素はNumber.prototype.toLocaleString()でローカライズされた文字列に変換され、その後カンマで結合されて一つの文字列として出力されます。この機能は、国際化(i18n)対応アプリケーションにおいて、数値データを世界中のユーザーが理解しやすい形式で提供する際に非常に有用です。元のTypedArrayオブジェクトは変更されません。

公式リファレンス: TypedArray.prototype.toLocaleString()

構文(syntax)

1const myTypedArray = new Uint8Array([10, 20, 30]);
2const formattedString = myTypedArray.toLocaleString();

引数(parameters)

locales = undefined, options = undefined

  • locales = undefined: 数値のフォーマットに使用するロケールを指定する文字列または文字列の配列。指定しない場合は、実行環境のデフォルトロケールが使用されます。
  • options = undefined: 数値のフォーマット方法を詳細に指定するオプションオブジェクト。

戻り値(return)

String

TypedArray.prototype.toLocaleString()は、TypedArrayの各要素をロケールに応じた文字列に変換し、それらを結合した文字列を返します。

関連コンテンツ

関連プログラミング言語