Number

数値は、255 や 3.14159 のようなリテラル形式で表現するのが最も一般的です。字句文法には、より詳しい参照があります。

255; // 二百五十五
255.0; // 同じ数値
255 === 255.0; // true
255 === 0xff; // true （16 進記法）
255 === 0b11111111; // true （2 進記法）
255 === 0.255e3; // true （10 進指数記法）

JavaScript コードにおける 37 のような数値リテラルは浮動小数点値であり、整数ではありません。日常的に使用される独立した整数型はありません。（JavaScript は長整数 (BigInt) 型を持つようになりましたが、日常の利用で数値を置き換えるように設計されてはいません。 37 は数値であり、長整数ではありません。）

関数として使用された場合、 Number(value) は文字列やその他の値を数値型に変換します。値が変換できない場合は、 NaN を返します。

Number("123"); // 数値 123 を返す
Number("123") === 123; // true

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

JavaScript の数値 (Number) 型は IEEE 754 の倍精度 64ビットバイナリー形式であり、 Java や C# の double のようなものです。つまり、小数値を表しますが、格納される数値の大きさと精度には制限があります。とても簡単に説明すると、IEEE 754 の倍精度数は、3 つの部分を表すのに 64 ビットを使用します。

• 1 ビットの符号（sign, 正の数または負の数）
• 11 ビットの指数部（exponent, -1022 から 1023）
• 52 ビットの仮数部（mantissa, 0 と 1 の間の数値を表す）

仮数部（significand とも呼ばれる）は、実際の値を表す部分（有効数字）です。指数は、仮数を乗じるべき 2 のべき乗です。科学的記数法として考えると、次のようになります。

仮数部は 52 ビットで格納され、2 進数の小数でい��ところの 1.… 以降の桁と解釈されます。したがって，仮数部の精度は 2^-52（Number.EPSILON で取得可能）、すなわち小数点以下 15 ～ 17 桁程度となります。演算は丸め誤差の影響を受けます。

数値が保持できる最大の値は 2¹⁰²³ × (2 - 2^-52)（2 進数で指数が 1023、仮数が 0.1111...）であり、これは Number.MAX_VALUE で取得可能です。それ以上の値は、特殊な数値定数 Infinity で置き換えられます。

整数は、仮数が 53 ビット（先頭の 1 も含む）しか保持できないため、精度を落とさずに表せるのは -2⁵³ + 1 から 2⁵³ - 1 の範囲（Number.MIN_SAFE_INTEGER と Number.MAX_SAFE_INTEGER で取得できる）だけです。

これについては、ECMAScript 標準に記述されています。

数字を期待する多くの組み込み演算は、最初に引数を数字に変換します（Numberオブジェクトが数字プリミティブと似たような動作をするのは、このためです）。この操作 は以下のように要約されます。

• 数値はそのまま返されます。
• undefined は NaN になります。
• null は 0 になります。
• true は 1 に、false は 0 になります。
• 文字列は、数値リテラルが入っているかのように解釈して変換されます。解釈に失敗した場合は NaN が返されます。実際の数値リテラルと比較すると、いくつかの異なる点があります。
  • 先頭および末尾のホワイトスペース/改行文字は無視されます。
  • 先頭が数字 0 である場合、数値が 8 進数のリテラルとなる（または厳格モードで拒否される）ことはありません。
  • 文字列の始めには、符号を示すために + と - を置くことができます。（実際のコードでは、これらはリテラルの一部に「見える」のですが、実際には別個の単項演算子です。）ただし、符号は一度しか現れず、空白が続いてはいけません。
  • Infinity と -Infinity はリテラルとして認識されます。実際のコードでは、これらはグローバル変数です。
  • 空文字列またはホワイトスペースのみの文字列は 0 に変換されます。
  • 数値の区切り文字は許可されません。
• 長整数は、意図しない精度の低下を防ぐために TypeError 例外が発生します。
• シンボルは TypeError 例外が発生します。
• オブジェクトはまずプリミティブに変換されます（[Symbol.toPrimitive]()を "number" のヒント付きで、valueOf()、toString() メソッドをこの順で呼び出すことで）。結果のプリミティブは数値へ変換されます。

JavaScript でほぼ同じ効果を得るには、2 つの方法があります。

• 単項プ��ス: +x は上で説明した数値変換の手順を、x を変換するためにそのまま実行します。
• Number() 関数: Number(x) は x を変換する同じアルゴリズムを使用します。ただし長整数は TypeError 例外を発生させず、精度が落ちる可能性があるものの、数値としての値を返します。

Number.parseFloat() および Number.parseInt() は Number() と似ていますが、文字列のみを若干異なる解釈ルールで変換します。例えば、parseInt() は小数点を解釈せず、 parseFloat() は 0x の接頭辞を解釈しません。

整数への変換

演算子の中には整数を期待するものがあり ます。特に、配列や文字列の添字、時刻の成分、数値の基数を扱う演算子はそうです。上記の数値強制の手順を実行した後、結果は切り捨てて（小数部分を捨てて）整数に変換します。数値が無限大 (±Infinity) の場合は、そのまま返します。数値が NaN または -0 の場合、0 を返します。したがって、結果は常に整数（-0ではない）か ±Infinity となります。

注目すべきは、整数に変換すると undefined も null も 0 になることです。これは undefined が NaN に変換され、これも 0 になるためです。

固定長数値への変換

JavaScript には整数の 2 進数エンコーダーを処理する低レベルの関数がいくつかあり、特にビット演算子と TypedArray オブジェクトが有名です。ビット演算子は常にオペランドを 32 ビット整数に変換します。この場合、値を数値に変換した後、最初の切り捨てで小数部を取り除き、次に整数の 2 の補数で最低ビットを導いて、数値を指定の幅に正規化します。

new Int32Array([1.1, 1.9, -1.1, -1.9]); // Int32Array(4) [ 1, 1, -1, -1 ]

new Int8Array([257, -257]); // Int8Array(2) [ 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(2) [ 1, 255 ]
// -257 = 1110 1111 1111
//      =      1111 1111 (mod 2^8)
//      = 255 (as unsigned integer)

Number()

Number オブジェクトを生成します。関数として呼び出された場合は、数値型のプリミティブ値を返します。

Number.EPSILON

数値として表される 2 個の数の最小の差です。

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.isFinite()

渡された値が有限数であるかどうかを判断します。

Number.isInteger()

渡された値が整数であるかどうかを判断します。

Number.isNaN()

渡された値が NaN であるかどうかを判断します。

Number.isSafeInteger()

渡された値が確実な範囲の整数（-(2⁵³ - 1) から 2⁵³ - 1 の間）であるかどうかを判断します。

Number.parseFloat()

これはグローバルの parseFloat() 関数と同じです。

Number.parseInt()

これはグローバルの parseInt() 関数と同じです。

これらのプロパティは Number.prototype に定義されており、すべての Number インスタンスで共有されます。

Number.prototype.constructor

インスタンスオブジェクトを作成したコンストラクター関数。Number インスタンスの場合、初期値は Number コンストラクターです。

Number.prototype.toExponential()

指数表記で数値を表す文字列を返します。

Number.prototype.toFixed()

固定小数点表記で数値を表す文字列を返します。

Number.prototype.toLocaleString()

この値を言語依存の表現で表す文字列を返します。 Object.prototype.toLocaleString() メソッドを上書きします。

Number.prototype.toPrecision()

指定された精度で、固定小数点表記��たは指数表記で数値で表す文字列を返します。

Number.prototype.toString()

指定された基数を元に、指定されたオブジェクトを表す文字列を返します。 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 を出力します。

• 最新の Number の動作（2 進数と 8 進数のリテラルに対応）のポリフィル (core-js)
• NaN
• 算術演算子
• Math グローバルオブジェクト
• 任���の精度の整数型: BigInt