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
支持 支持 支持 支持 支持 支持