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

Number.prototype.toPrecision()メソッドは、指定された有効桁数で数値を表現する文字列に変換するメソッドです。

このメソッドは、Numberオブジェクトのインスタンスから呼び出すことができ、数値の表示形式を特定の精度で制御したい場合に非常に有用です。引数としてprecision（精度）を受け取り、このprecisionは数値全体の有効桁数を決定します。これは小数点以下の桁数ではなく、数値全体の桁数を指します。例えば、123.45にtoPrecision(3)を適用すると"123"となります。また、12.345であれば"12.3"となり、1.2345であれば"1.23"となります。指定された精度に合わせて、元の数値は適切に丸められます。もし数値が指定された精度で表現できないほど桁数が多い場合、例えば123456789にtoPrecision(3)を適用すると、"1.23e+8"のような指数表記が使用されることがあります。

引数precisionはオプションであり、省略された場合、このメソッドはNumber.prototype.toString()メソッドと同様の動作をします。precisionの有効な範囲は1から100までであり、この範囲外の値を指定するとRangeErrorが発生します。財務計算や科学技術計算など、数値の表示精度を厳密に管理する必要がある場面で特に役立ちます。

Copy
1const numberValue = 123.456789;
2const preciseString = numberValue.toPrecision(5);

precision

• precision: number: 数値を表す精度を指定する整数。指定された精度で数値を文字列として返します。

String

指定された精度で数値を表す文字列を返します。