parseFloat()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
parseFloat() 関数は、引数を (必要に応じてまず文字列に変換してから) 解釈し、浮動小数点値を返します。
試してみましょう
function circumference(r) { return parseFloat(r) * 2.0 * Math.PI;}console.log(circumference(4.567));// Expected output: 28.695307297889173console.log(circumference("4.567abcdefgh"));// Expected output: 28.695307297889173console.log(circumference("abcdefgh"));// Expected output: NaN構文
parseFloat(string)
引数
返値
指定されたstring を解釈した浮動小数点値です。
または、最初のホワイトスペース以外の文字が数値に変換できなかった場合はNaN です。
解説
parseFloat は最上位関数であり、どのオブジェクトのメソッドでもありません。
parseFloatが正の符号 (+)、負の符号 (-U+002D HYPHEN-MINUS)、数値 (0–9)、小数点 (.)、指数記号 (eまたはE) 以外の文字に遭遇したら、その文字の前までの値を返し、無効な文字とそれ以降の文字を無視します。- 2 番目の小数点に遭遇した場合も、解析を停止します (その位置より前までの文字は解析されます)。
- 引数にある前後の空白は無視されます。
- 引数の最初の文字が数値に変換できない場合 (上記のいずれでもない場合),
parseFloatはNaNを返します。 parseFloatはInfinityを解析し、返すことができます。parseFloatはBigIntの構文をNumbersに変換し、精度は下がります。これは最後のnの文字が破棄されるからです。
より厳密な構文解析にはNumber(value) を検討してください。これは、引数のどこかに無効な文字があるとNaN に変換します。
parseFloat はtoString またはvalueOf メソッドが定義されているオブジェクトを解析することもできます。返値はparseFloat がこれらのメソッドの返値で呼び出された場合と同じです。
例
数値を返すparseFloat
以下の例はすべて3.14 を返します。
js
parseFloat(3.14);parseFloat("3.14");parseFloat(" 3.14 ");parseFloat("314e-2");parseFloat("0.0314E+2");parseFloat("3.14some non-digit characters");parseFloat({ toString: function () { return "3.14"; },});NaN を返すparseFloat
以下の例はNaN を返します。
js
parseFloat("FF2");parseFloat とBigInt
以下の例はどちらも900719925474099300 を返します。 float として表現できないほど整数が大きいので、精度が失われます。
js
parseFloat(900719925474099267n);parseFloat("900719925474099267n");仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-parsefloat-string |