Skip to content

Commit

Permalink
[zh-cn]: update translation of Number.toPrecision() (#16150)
Browse files Browse the repository at this point in the history
Co-authored-by: Jason Ren <[email protected]>
  • Loading branch information
JasonLamv-t and jasonren0403 authored Sep 28, 2023
1 parent 531a091 commit 61dd100
Showing 1 changed file with 14 additions and 11 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -3,36 +3,39 @@ title: Number.prototype.toPrecision()
slug: Web/JavaScript/Reference/Global_Objects/Number/toPrecision
---

{{JSRef("Global_Objects", "Number")}}
{{JSRef}}

## 概述
{{jsxref("Number")}} 值的 **`toPrecision()`** 方法返回一个以指定精度表示该数字的字符串。

**`toPrecision()`** 方法以指定的精度返回该数值对象的字符串表示。
{{EmbedInteractiveExample("pages/js/number-toprecision.html")}}

## 语法

```plain
numObj.toPrecision(precision)
```js-nolint
toPrecision()
toPrecision(precision)
```

### 参数

- `precision` {{optional_inline}}
- : 一个用来指定有效数个数的整数
- : 一个指定有效位数的整数

### 返回值

以定点表示法或指数表示法表示的一个数值对象的字符串表示,四舍五入到 `precision` 参数指定的显示数字位数。查看 {{jsxref("Number.prototype.toFixed()")}} 方法关于四舍五入的讨论,同样应用于 `toPrecision` 方法
一个以定点表示法或指数表示法表示 {{jsxref("Number")}} 对象的字符串,该字符串四舍五入到 `precision` 个有效数字。有关四舍五入的讨论,请参阅 {{jsxref("Number.prototype.toFixed()")}} 方法的描述,其也适用于 `toPrecision()`

如果忽略 `precision` 参数,则该方法表现类似于 {{jsxref("Number.prototype.toString()")}}。如果该参数是一个非整数值,将会向下舍入到最接近的整数
如果 `precision` 参数被省略,则与 {{jsxref("Number.prototype.toString()")}} 行为相同。如果 `precision` 参数不是整数,则将其四舍五入到最近的整数

### 异常

- {{jsxref("Global_Objects/RangeError", "RangeError")}}
- : 如果 _precison_ 参数不在 1 和 100(包括)之间,将会抛出一个 `RangeError` 。执行环境也可以支持更大或更小的范围。ECMA-262 只需要最多 21 位显示数字
- : 如果 `precision` 不在 `1``100` 之间(包含两端),则抛出该错误

## 示例

### 使用 `toPrecision`

```js
let numObj = 5.123456;

Expand All @@ -48,7 +51,7 @@ console.log(numObj.toPrecision(5)); // 输出 '0.00012300'
console.log(numObj.toPrecision(2)); // 输出 '0.00012'
console.log(numObj.toPrecision(1)); // 输出 '0.0001'

// 请注意,在某些情况下可能会返回科学计数法字符串
// 请注意,在某些情况下可能会返回指数表示法字符串
console.log((1234.5).toPrecision(2)); // 输出 '1.2e+3'
```

Expand All @@ -60,7 +63,7 @@ console.log((1234.5).toPrecision(2)); // 输出 '1.2e+3'

{{Compat}}

## 相关链接
## 参见

- {{jsxref("Number.prototype.toFixed()")}}
- {{jsxref("Number.prototype.toExponential()")}}
Expand Down

0 comments on commit 61dd100

Please sign in to comment.