Number

数值通常以字面量形式表示。如 0b101、0o13、0x0A。词法文法包含更详细的参考。

123; // one-hundred twenty-three
123.0; // same
123 === 123.0; // true

在 JavaScript 代码中，像 37 这样的数值字面值是一个浮点值，而不是整数。在常见的日常使用中，没有单独的整数类型。（JavaScript 也有 BigInt 类型，但它不是为取代日常使用的 Number 而设计的。37 仍然是一个数值，而不是 BigInt。）

当作为一个函数使用时，Number(value) 将转换字符串或者其它值到 Number 类型。如果该值不能被转换，它会返回 NaN。

Number("123"); // returns the number 123
Number("123") === 123; // true

Number("unicorn"); // NaN
Number(undefined); // NaN

JavaScript 的 Number 类型是一个双精度 64 位二进制格式 IEEE 754 值，类似于 Java 或者 C# 中的 double。这意味着它可以表示小数值，但是存储数值的大小和精度有一些限制。简而言之，IEEE 754 双精度浮点数使用 64 位来表示 3 个部分：

• 1 比特符号位（sign）（正数或者负数）
• 11 比特指数位（exponent）（-1022 到 1023）
• 52 比特尾数位（mantissa）（表示 0 和 1 之间的数值）

尾数（也称为有效位数）是表示实际值的数值（有效数值）部分。指数是尾数应乘以的 2 的幂。将其视为科学计数法：

$$\text{Number} = ({-1})^{\text{sign}} \cdot (1 + \text{mantissa}) \cdot 2^{\text{exponent}}$$

尾数使用 52 比特存储，在二进制小数中解释为 1.… 之后的数值。因此，尾数的精度是 2^-52（可以通过 Number.EPSILON 获得），或者十进制小数点后大约 15 到 17 位；高于该精度级别的算术需要舍入。

一个数值可以容纳的最大值是 2¹⁰²⁴ - 1（基于二进制的指数为 1023，尾数为 0.1111...），这可以通过 Number.MAX_VALUE 获得。大于该值的数值，被特殊数常数 Infinity 取代。

只有在 -2⁵³ + 1 到 2⁵³ - 1 范围内的整数才能在不丢失精度的情况下被表示（可通过 Number.MIN_SAFE_INTEGER 和 Number.MAX_SAFE_INTEGER 获得），因为尾数只能容纳 53 位（包括前导 1）。

有关这一点的更多详细信息，请参阅 ECMAScript 标准。

许多期望数值的内置操作是将它们的参数转换为数值（这在很大程度上就是为什么 Number 对象的行为与数值原始值相似的原因）。该操作可以总结如下：

• 对于 Number 则总是返回自己
• undefined 变成了 NaN。
• null 变成了 0。
• true 变成了 1；false 变成了 0。
• 如果它们包含数字字面量，字符串通过解析它们来转换。如果解析失败，返回的结果为 NaN。与实际数字字面量相比，它们有一些细微的差别。
  • 忽略前导和尾随空格/行终止符。
  • 前导数值 0 不会导致该数值成为八进制文本（或在严格模式下被拒绝）。
  • + 和 - 允许在字符串的开头指示其符号。（在实际代码中，它们“看起来像”文字的一部分，但实际上是单独的一元运算符。）然而，该标志只能出现一次，不得后跟空格。
  • Infinity 和 -Infinity 被当作是字面量。在实际代码中，它们是全局变量。
  • 空字符串或仅空格字符串转换为 0。
  • 不允许使用数字分隔符。
• BigInt 抛出 TypeError，以防止意外的强制隐式转换损失精度。
• Symbol 抛出 TypeError。
• 对象首先按顺序调用 @@toPrimitive]()（将 "number" 作为 hint）、valueOf() 和 toString() 方法将其转换为原始值。然后将生成的原始值转换为数值。

有两种方法可以在 JavaScript 中实现几乎相同的效果。

• 一元加：+x 完全按照上面的数值强制转换步骤来转换 x。
• Number() 函数：Number(x) 使用相同的算法转换 x，除了 BigInt 不会抛出 TypeError，而是返回它的 Number 值，并且可能损失精度。

Number.parseFloat() 和 Number.parseInt() 与 Number() 相似，但只转换字符串，并且解析规则略有不同。例如，parseInt() 无法识别小数点，parseFloat() 无法识别 0x 前缀。

整数转换

一些操作需要整数，最值得注意的是那些适用于数组/字符串索引、日期/时间组件和数值基数的整数。执行上述数值强制转换步骤后，结果被截断为整数（通过丢弃分数部分）。如果数值为 ±Infinity，则按原样返回。如果数值是 NaN 或 -0，则返回为 0。因此，结果总是整数（不是 -0）或 ±Infinity。

值得注意的是，当转换到整数时，undefined 和 null 都会变成 0，因为 undefined 被转换为 NaN，NaN 也变成了 0。

固定宽度数值转换

JavaScript 有一些较低级别的函数，用于处理整数的二进制编码，最值得注意的是按位运算和 TypedArray 对象。按位运算总是将操作数转换为 32 位整数。在这些情况下，将值转换为数值后，然后首先截断小数部分，然后在整数的二进制的补码编码中取最低位，将数值归一化为给定的宽度。

new Int32Array([1.1, 1.9, -1.1, -1.9]); // Int32Array(4) [ 1, 1, -1, -1 ]
new Int8Array([257, -257]); // Int8Array(1) [ 1, -1 ]
// 257 = 0001 0000 0001 = 0000 0001 (mod 2^8) = 1
// -257 = 1110 1111 1111 = 1111 1111 (mod 2^8) = -1 (as signed integer)
new Uint8Array([257, -257]); // Uint8Array(1) [ 1, 255 ]
// -257 = 1110 1111 1111 = 1111 1111 (mod 2^8) = 255 (as unsigned integer)

Number()

创建一个新的 Number 值。

当 Number 作为一个构造函数（用 new）调用时，它会创建一个 Number 对象，该对象不是一个原始值。例如，typeof new Number(42) === "object"，并且 new Number(42) !== 42（尽管 new Number(42) == 42）。

Number.EPSILON

两个可表示数之间的最小间隔。

Number.MAX_SAFE_INTEGER

JavaScript 中最大的安全整数（2⁵³ - 1）。

Number.MAX_VALUE

能表示的最大正数。

Number.MIN_SAFE_INTEGER

JavaScript 中最小的安全整数（-(2⁵³ - 1)）。

Number.MIN_VALUE

能表示的最小正数即最接近 0 的正数（实际上不会变成 0）。

Number.NaN

特殊的“Not a Number”（非数字）值。

Number.NEGATIVE_INFINITY

特殊的负无穷大值，在溢出时返回该值。

Number.POSITIVE_INFINITY

特殊的正无穷大值，在溢出时返回该值。

Number.prototype (en-US)

Number 对象上允许的额外属性。

Number.isNaN()

确定传递的值是否是 NaN。

Number.isFinite()

确定传递的值类型及本身是否是有限数。

Number.isInteger()

确定传递的值类型是 number，且是整数。

Number.isSafeInteger()

确定传递的值是否为安全整数（数值在 -(2⁵³ - 1) 和 2⁵³ - 1）之间。

Number.parseFloat()

和全局对象 parseFloat() 一样。

Number.parseInt()

和全局对象 parseInt() 一样。

Number.prototype.toExponential()

返回使用指数表示法表示数值的字符串。

Number.prototype.toFixed()

返回使用定点表示法表示数值的字符串。

Number.prototype.toLocaleString()

返回数值在特定语言环境下表示的字符串。覆盖 Object.prototype.toLocaleString() 方法。

Number.prototype.toPrecision()

返回数值使用定点表示法或指数表示法至指定精度的字符串。

Number.prototype.toString()

返回一个代表给定对象的字符串，基于指定的基数（radix）。覆盖 Object.prototype.toString() 方法。

Number.prototype.valueOf()

返回指定对象的原始值。覆盖 Object.prototype.valueOf() 方法。

下例使用 Number 对象的属性给几个数字变量赋值：

const biggestNum = Number.MAX_VALUE;
const smallestNum = Number.MIN_VALUE;
const infiniteNum = Number.POSITIVE_INFINITY;
const negInfiniteNum = Number.NEGATIVE_INFINITY;
const notANum = Number.NaN;

以下示例显示了可以表示为 Number 对象的最小和最大整数值。

const biggestInt = Number.MAX_SAFE_INTEGER; // (2**53 - 1) => 9007199254740991
const smallestInt = Number.MIN_SAFE_INTEGER; // -(2**53 - 1) => -9007199254740991

当解析已序列化为 JSON 的数据时，如果 JSON 解析器将它们强制为 Number 类型时，超出此范围的整数值可能会被损坏。

一个可能的变通办法是使用 String。

较大的数值可以使用 BigInt 类型表示。

以下示例使用 Number 作为函数将 Date 对象转换为数值：

const d = new Date("December 17, 1995 03:24:00");
console.log(Number(d));

这将输出 819199440000。

• 在 core-js 中现代 Number 行为的 Polyfill（支持二进制和八进制字面量）
• NaN
• 算术操作符
• Math 全局对象
• 任意精度的整数：BigInt