Number

Number JavaScript オブジェクトは、数値に作用するラッパーオブジェクトです。Number オブジェクトは、Number() コンストラクタを用いて生成します。プリミティブ型オブジェクト number は Number() 関数を用いて生成します。

JavaScript の Number 型は 倍精度 64 bit バイナリ形式 IEEE 754 の値です。最近の実装では、JavaScriptは BigInt 型を使って任意の精度の整数もサポートします。

構文

new Number(value); 
var a = new Number('123'); // a === 123 is false
var b = Number('123'); // b === 123 is true
a instanceof Number; // is true
b instanceof Number; // is false

引数

value

生成されるオブジェクトの数値です。

説明

Number オブジェクトの主な用途は:

• 引数が数に変換できない場合、NaN を返します。
• 非コンストラクタコンテキスト (すなわち、new 演算子なし) では、型変換を行うために使われます。

プロパティ

Number.EPSILON

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

Number.MAX_SAFE_INTEGER

JavaScript における確実な整数の最大値 (253 - 1)です。

Number.MAX_VALUE

表現可能な正の数の最大値です。

Number.MIN_SAFE_INTEGER

JavaScript における確実な整数の最小値 (-(253 - 1))です。

Number.MIN_VALUE

表現可能な正の数の最小値。0 に最も近い正の数です (0 ではありません)。

Number.NaN

"数値ではない" ("not a number") ことを表す特別な値です。

Number.NEGATIVE_INFINITY

負の無限大を表す特別な値です。オーバーフロー時に返されます。

Number.POSITIVE_INFINITY

無限大を表す特別な値です。オーバーフロー時に返されます。

Number.prototype

Number オブジェクトへのプロパティの追加を許可します。

メソッド

Number.isNaN()

渡された値が NaN であれば true を返します。

Number.isFinite()

渡された値が有限数であれば true を返します。

Number.isInteger()

渡された値が整数であれば true を返します。

Number.isSafeInteger()

渡された値が確実な範囲の整数 (-(253 - 1) から 253 - 1 の間) であれば true を返します。

Number.toInteger()

渡された値を評価し、整数値 (または Infinity) に変換します。ただし、このメソッドは廃止されました。

Number.parseFloat()

値はグローバルオブジェクトの parseFloat() と同じです。

Number.parseInt()

値はグローバルオブジェクトの parseInt() と同じです。

Number インスタンス

すべての Number インスタンスは、Number.prototype を継承します。Number コンストラクタの prototype オブジェクトは、すべての Number インスタンスに影響を及ぼします。

メソッド

例

Number オブジェクトを使用して変数に値を代入する

以下の例では、Number オブジェクトのプロパティを使用して、いくつかの数の変数に値を代入します。

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

Number の整数範囲

次の例は、Number オブジェクトで表現可能な最小の整数値と最大の整数値です (詳細は、ECMAScript 標準の 6.1.6 The Number Type の章を参照してください):

var biggestInt = Number.MAX_SAFE_INTEGER; //(253 - 1) => 9007199254740991;
var smallestInt = Number.MIN_SAFE_INTEGER;  //-(253 - 1) => -9007199254740991;

JSON にシリアライズされたデータを解析する場合、この範囲を超えた整数値は、JSON パーサがこの値を Number 型に強制すると信頼できない値になるでしょう。可能な回避策として、代わりに String を使用してください。

大きい数値は BigInt 型を用いて表すことができます。

Number を使用して Date オブジェクトを変換する

以下の例は、Number を関数として用いて、Date オブジェクトを数値に変換します:

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

これは、コンソールに "819199440000" を出力します。

数字や null を数値に変換する

Number('123')     // 123
Number('12.3')    // 12.3
Number('12.00')   // 12
Number('123e-1')  // 12.3
Number('')        // 0
Number(null)      // 0
Number('0x11')    // 17
Number('0b11')    // 3
Number('0o11')    // 9
Number('foo')     // NaN
Number('100a')    // NaN
Number('-Infinity') //-Infinity

仕様

ブラウザー実装状況

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

関連情報

• NaN
• Math グローバルオブジェクト
• Integers with arbitrary precision: BigInt
• Number type in details