parseInt()

試してみましょう

console.log(parseInt("123"));
// 123 (default base-10)
console.log(parseInt("123", 10));
// 123 (explicitly specify base-10)
console.log(parseInt("   123 "));
// 123 (whitespace is ignored)
console.log(parseInt("077"));
// 77 (leading zeros are ignored)
console.log(parseInt("1.9"));
// 1 (decimal part is truncated)
console.log(parseInt("ff", 16));
// 255 (lower-case hexadecimal)
console.log(parseInt("0xFF", 16));
// 255 (upper-case hexadecimal with "0x" prefix)
console.log(parseInt("xyz"));
// NaN (input can't be converted to an integer)

構文

parseInt(string)
parseInt(string, radix)

引数

string

整数で始まる文字列です。この引数では先頭のホワイトスペースは無視されます。

radix 省略可

2 から 36 までの整数で、string の基数（数学的記数法の底）を表します。これは 32 ビット整数に変換されます。変換後にそれが 0 でなく、 [2, 36] の範囲外であった場合、この関数は常に NaN を返します。0 または指定されなかった場合、基数は string の値に基づいて推測されます。既定で常に 10 になるわけではありません。下記の解説では、 radix が提供されなかった場合に何が起こるかをもっと詳細に説明しています。

返値

指定された string を解釈した整数値です。また、次の場合は NaN が返されます。

• radix を 32 ビット整数にした値が 2 よりも小さいか 36 よりも大きい、または
• ホワイトスペース以外の最初の文字が数値に変換できない。

解説

parseInt 関数は第 1 引数を文字列に変換し、解釈したうえで、整数または NaN を返します。

NaN でない場合は、返値は第 1 引数を指定された radix で数値として解釈した整数値になります。(例えば、radix が 10 であれば 10 進数からの変換で、8 であれば 8 進数からの変換で、16 であれば 16 進数からの変換、などです。)

radix 引数は数値に変換されます。提供されなかった場合、または値が 0、NaN、Infinity のいずれかであった場合（undefined は NaN に強制されます）、 JavaScript は以下のように想定します。

1. 入力された string の先頭のホワイトスペースと、存在すれば +/- 符号が除去され、 0x または 0X （ゼロ、従うこと以下で小文字または大文字の X）で始まっている場合、 radix は 16 とみなされ、文字列の残りの部分は 16 進数として解釈されます。
2. 入力された string が他の何らかの値で始まる場合、基数は 10 （10 進数）になります。

基数が 16 の場合、 parseInt() では、オプションで符号文字 (+/-) の後に 0x または 0X を接頭辞として文字列を指定することができます。

（必要に応じて数値に変換された）基数の値が [2, 36] （両端を含む）の範囲になかった場合は、 parseInt は NaN を返します。

10 以上の基数については、9 より大きい数字はアルファベットで示されます。たとえば、 16 進数（基数 16）では A から F が用いられます。文字の大文字小文字は区別しません。

parseInt は 2 つの符号を正確に理解します。+ は正の符号で、- は負の符号です。これは解釈の最初の段階で、ホワイトスペースを除去した後に行われます。符号が見つからなかった場合は、アルゴリズムは次の段階に移行します。そうでなければ、符号を取り除いて残りの文字列の数値の解釈を実行します。

parseInt は、入力文字列の中で、指定された radix で有効な数字ではない文字を見つけた場合、その文字とそれ以降のすべての文字を無視し、その時点までに構文解析した整数値返します。例えば、parseInt("2", 2) は、2 は 2 進数では有効な数字ではないため、NaN を返します。例えば、 1e3 は技術的には整数をエンコードしたものですが、（そして parseFloat() では正しく 1000 と解釈されますが）、 parseInt("1e3", 10) は 1 を返します。 e は基数 10 の有効な数字ではないからです。 . も数字ではないので、返値は常に整数になります。

最初の文字が使用している基数で数字に変換できなかった場合は、 parseInt は NaN を返します。先頭のホワイトスペースは許容されます。

数値演算の目的では、NaN は基数がいくつであっても数値にはなりません。 Number.isNaN 関数を使うと、 parseInt の結果が NaN であるかどうか確かめられます。数値演算で NaN が与えられると、演算結果も NaN になります。

巨大な数値では e の文字を文字列表現の中で使用しますので（例えば 6.022E23 は 6.022 × 10^23 を表します）、parseInt を使用して数値を切り捨てると、とても大きな数字やとても小さな数字を使用する際に予期しない結果を生み出すことがあります。 parseInt を Math.trunc() の代用として使うべきではありません。

数値を基数を指定してその文字列表現に変換するには、thatNumber.toString(radix) を用います。

parseInt() は数値を返すので、文字列が表す整数が安全な範囲の外の場合、精度が落ちる可能性があります。 BigInt() 関数は BigInt を返すことで、任意の長さの整数を正確に解釈することに対応しています。

例

parseInt() の使用

以下の例はいずれも 15 を返します。

parseInt("0xF", 16);
parseInt("F", 16);
parseInt("17", 8);
parseInt("015", 10);
parseInt("15,123", 10);
parseInt("FXX123", 16);
parseInt("1111", 2);
parseInt("15 * 3", 10);
parseInt("15e2", 10);
parseInt("15px", 10);
parseInt("12", 13);

以下の例はいずれも NaN を返します。

parseInt("Hello", 8); // まったく数字ではない
parseInt("546", 2); // 2 進数では 0 または 1 以外の数字は無効

以下の例はいずれも -15 を返します。

parseInt("-F", 16);
parseInt("-0F", 16);
parseInt("-0XF", 16);
parseInt("-17", 8);
parseInt("-15", 10);
parseInt("-1111", 2);
parseInt("-15e1", 10);
parseInt("-12", 13);

以下の例は 224 を返します。

parseInt("0e0", 16);

parseInt() は BigInt の値を扱いません。 n の文字で解釈を停止し、それまでの文字列を通常の整数として扱うため、精度が落ちる可能性があります。

parseInt("900719925474099267n");
// 900719925474099300

代わりに、文字列を末尾の n なしで BigInt() 関数に渡してください。

BigInt("900719925474099267");
// 900719925474099267n

parseInt は数値の区切り文字を扱うことができません。

parseInt("123_456"); // 123

文字列でないものに対する parseInt() を使用

parseInt() は、文字列でないものを大きな基数で扱う場合に興味深い結果をもたらすことがあります。例えば、 36 の場合です（これはすべての英数字を有効な数字にします）。

parseInt(null, 36); // 1112745: "null" の文字列は 36 進数で 1112745
parseInt(undefined, 36); // 86464843759093: "undefined" の文字列は 36 進数で 86464843759093

一般に、parseInt() を文字列以外で使用すること、特に Math.trunc() の代用として使用するのは良くない考えです。小さな数では使えるかもしれません。

parseInt(15.99, 10); // 15
parseInt(-15.1, 10); // -15

しかし、これはたまたま、この数値の文字列表現が基本的な小数表記 ("15.99", "-15.1") を使用しており、 parseInt() が小数点で止まっているためにうまく動作しているだけです。 1e+21 以上または 1e-7 以下の数値は、文字列表現に指数表記 ("1.5e+22", "1.51e-8") を使用するため、 parseInt() は常に最初の桁の後に来る e の文字または小数点で停止します。つまり、大きな数でも小さな数でも、 parseInt() は 1 桁の整数を返すということです。

parseInt(4.7 * 1e22, 10); // 巨大な数値が 4 になる
parseInt(0.00000000000434, 10); // 極小の数値が 4 になる

parseInt(0.0000001, 10); // 1
parseInt(0.000000123, 10); // 1
parseInt(1e-7, 10); // 1
parseInt(1000000000000000000000, 10); // 1
parseInt(123000000000000000000000, 10); // 1
parseInt(1e21, 10); // 1

仕様書

ブラウザーの互換性

関連情報

• parseFloat()
• Number() コンストラクター
• Number.parseFloat()
• Number.parseInt()
• isNaN()
• Number.prototype.toString()
• Object.prototype.valueOf()
• BigInt() コンストラクター