JavaScript Number toPrecision() 方法

定義和用法

toPrecision() 方法將數字格式化為指定長度。

該方法格式化數字的有效位。

實例

例子 1

將數字格式化為指定長度：

let num = 13.3714;
let n = num.toPrecision(2);

親自試一試

例子 2

格式化小數：

let num = 0.001658853;
num.toPrecision(2);
num.toPrecision(3);
num.toPrecision(10);

親自試一試

例子 3

將數字格式化為指定長度：

let num = 13.3714;
num.toPrecision(2);
num.toPrecision(3);
num.toPrecision(10);

親自試一試

例子 4

無格式：

let num = 13.3714;
num.toPrecision();

親自試一試

語法

number.toPrecision(precision)

參數

參數 描述
precision

可選。位數。

1 ~ 21 之間（且包括 1 和 21）的值。

如果省略，則返回不帶任何格式的數字。

返回值

類型 描述
字符串 格式化為指定精度的數字。

技術細節

返回值

返回 Number 的字符串表示，包含 precision 個有效數字。

如果 precision 足夠大，能夠包括 Number 整數部分的所有數字，那么返回的字符串將采用定點計數法。

否則，采用指數計數法，即小數點前有一位數字，小數點后有 precision-1 位數字。

必要時，該數字會被舍入或用 0 補足。

拋出

異常 描述
RangeError

當 precision 太小或太大時拋出的異常。

1 ~ 21 之間的值不會引發該異常。

有些實現支持更大范圍或更小范圍內的值。
TypeError 當調用該方法的對象不是 Number 時拋出的異常。

瀏覽器支持

toPrecision() 是 ECMAScript3 (ES3) 特性。

所有瀏覽器都完全支持 ES3 (JavaScript 1999)：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持