JavaScript Number toPrecision() 方法

JavaScript Number 的toPrecision()方法用于检索表示此数字的指定精度的字符串，或者将其格式化为指定精度的输入数字。精度描述用于表达值的数字位数。

如果“precision”参数的值不在 [0, 100] 范围内，则会抛出“RangeError”异常。如果未为此方法指定“precision”参数值，则返回相同的输出。

注意：如果精度值大于数字的总位数，则会在数字末尾添加额外的零。

语法

以下是 JavaScript Number 的toPrecision()方法的语法：

toPrecision(precision)

参数

此方法采用一个名为“precision”的可选参数，如下所述：

precision（可选） - 指定有效数字个数的整数。

返回值

此方法返回格式化为指定精度的数字。

示例 1

JavaScript number 的toPrecision()方法将数字格式化为指定的精度或长度。如果省略精度值，则按原样返回数字。

<html>
<head>
<title>JavaScript toPrecision() Method</title>
</head>
<body>
<script>
   const val = 10.34543;
   document.write("Given value = ", val);
   document.write("<br>Result = ", val.toPrecision());
</script>
</body>
</html>

输出

上述程序在输出中返回“10.34543”：

Given value = 10.34543
Result = 10.34543

示例 2

Number 的toPrecision()方法将输入值格式化为指定的精度，如果将“precision”参数值传递给它。

<html>
<head>
<title>JavaScript toPrecision() Method</title>
</head>
<body>
<script>
   const val = 123.3454;
   const p1 = 3;
   const p2 = 5;
   const p3 = 12;
   document.write("Given value = ", val);
   document.write("<br>Precision values are = ", p1, ", ", p2, " and ", p3);
   document.write("<br>Formatted result1 = ", val.toPrecision(p1));
   document.write("<br>Formatted result2 = ", val.toPrecision(p2));
   document.write("<br>Formatted result3 = ", val.toPrecision(p3));
</script>
</body>
</html>

输出

上述程序根据指定的精度格式化输入值。

Given value = 123.3454
Precision values are = 3, 5 and 12
Formatted result1 = 123
Formatted result2 = 123.35
Formatted result3 = 123.345400000

示例 3

如果可选参数“precision”的值不在[1, 100]范围内，则此方法会抛出“RangeError”异常。

<html>
<head>
<title>JavaScript toPrecision() Method</title>
</head>
<body>
<script>
   const val = 123;
   const precision = 101;
   document.write("Given value = ", val);
   document.write("<br>Precision value = ", precision);
   try {
      document.write("<br>Result = ", val.toPrecision(precision));
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

上述程序抛出“RangeError”异常，如下所示：

Given value = 123
Precision value = 101
RangeError: toPrecision() argument must be between 1 and 100

打印页面