From 61dd10032cc30a031598e7b794308ea6dc7f740d Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Thu, 28 Sep 2023 16:00:02 +0800 Subject: [PATCH] [zh-cn]: update translation of Number.toPrecision() (#16150) Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../number/toprecision/index.md | 25 +++++++++++-------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/number/toprecision/index.md b/files/zh-cn/web/javascript/reference/global_objects/number/toprecision/index.md index 01416872eba79c..44f622e0f4647e 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/number/toprecision/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/number/toprecision/index.md @@ -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; @@ -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' ``` @@ -60,7 +63,7 @@ console.log((1234.5).toPrecision(2)); // 输出 '1.2e+3' {{Compat}} -## 相关链接 +## 参见 - {{jsxref("Number.prototype.toFixed()")}} - {{jsxref("Number.prototype.toExponential()")}}