Number.prototype.toPrecision()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
toPrecision() メソッドは Number オブジェクトを指定された精度で表した文字列を返します。
試してみましょう
function precise(x) {
return x.toPrecision(4);
}
console.log(precise(123.456));
// Expected output: "123.5"
console.log(precise(0.004));
// Expected output: "0.004000"
console.log(precise(1.23e5));
// Expected output: "1.230e+5"
構文
js
toPrecision()
toPrecision(precision)
引数
precision省略可-
有効数字の数を指定する整数です。
返値
Number オブジェクトを precision で指定された桁で概数化された、固定小数点数、または指数表記で表した文字列です。概数の表現方法については Number.prototype.toFixed() メソッドの説明を参照してください。それは toPrecision() にも適用されます。
引数 precision が省略された場合、 Number.prototype.toString() のように振舞います。 precision が整数の値ではない場合は、最も近い整数に概数化されます。
例外
RangeError-
precisionが1以上 100 以下の範囲にない場合に発生します。
例
toPrecision の使用
js
let num = 5.123456;
console.log(num.toPrecision()); // '5.123456'
console.log(num.toPrecision(5)); // '5.1235'
console.log(num.toPrecision(2)); // '5.1'
console.log(num.toPrecision(1)); // '5'
num = 0.000123;
console.log(num.toPrecision()); // '0.000123'
console.log(num.toPrecision(5)); // '0.00012300'
console.log(num.toPrecision(2)); // '0.00012'
console.log(num.toPrecision(1)); // '0.0001'
// なお、場合によっては指数表記が返されることがあります。
console.log((1234.5).toPrecision(2)); // '1.2e+3'
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-number.prototype.toprecision |