Number.prototype.toPrecision()

toPrecision() メソッドは Number オブジェクトを指定された精度で表した文字列を返します。

<table class="fullwidth-table"> <tr> <td class="header" colspan="2">Method of Number</td> </tr> <tr> <td>実装されたバージョン</td> <td>JavaScript 1.5</td> </tr> <tr> <td>ECMA バージョン</td> <td>ECMA-262</td> </tr> </table>

構文

numObj.toPrecision([precision])

引数

precision

有効数字の数を指定する整数。オプション。

戻り値

Number オブジェクトを precision で指定された桁で概数化された、固定小数点数、または、指数表記で表した文字列。概数の表現方法については、Number.prototype.toFixed() メソッドの説明を参照してください。それは、toPrecision メソッドにも適用されます。

もし 引数 precision が省略された場合、Number.prototype.toString() のように振舞います。整数値ではない場合は、最も近い整数に概数化されます。概数化した後、その値が 1 以上 かつ 100 以下ではない場合、RangeError が投げられます。

例外

RangeError

If precision is not between 1 and 100 (inclusive), a RangeError is thrown. Implementations are allowed to support larger and smaller values as well. ECMA-262 only requires a precision of up to 21 significant digits.

例

var num = 5.123456;

console.log(numObj.toPrecision());    // logs '5.123456'
console.log(numObj.toPrecision(5));   // logs '5.1235'
console.log(numObj.toPrecision(2));   // logs '5.1'
console.log(numObj.toPrecision(1));   // logs '5'

numObj = 0.000123

console.log(numObj.toPrecision());    // logs '0.000123'
console.log(numObj.toPrecision(5));   // logs '0.00012300'
console.log(numObj.toPrecision(2));   // logs '0.00012'
console.log(numObj.toPrecision(1));   // logs '0.0001' 

// note that exponential notation might be returned in some circumstances
console.log((1234.5).toPrecision(2)); // logs '1.2e+3'

仕様

ブラウザ実装状況

参照

• toExponential
• toFixed
• toString