Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】Number::parseFloat()メソッドの使い方

parseFloatメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

parseFloatメソッドは、引数として渡された文字列を解析し、浮動小数点数(小数)に変換して返すメソッドです。このメソッドは、Numberクラスに属しており、Node.jsの標準機能として提供されています。

変換の際には、文字列の先頭から数字、符号(+や-)、小数点、そして指数表記(eやE)といった数値として有効な文字を順に読み込みます。数値として解釈できない文字に初めて遭遇した時点で、その文字以降の解析を停止し、それまでに読み取った部分を数値として変換します。文字列の先頭に空白文字があっても、それは無視されて解析が開始されます。

例えば、「3.14px」という文字列を渡した場合、「3.14」が数値として抽出されます。しかし、文字列の先頭が数字として認識できない文字で始まる場合(例:「px3.14」)、NaN(Not-a-Number)という特殊な値を返します。これは、有効な数値に変換できなかったことを示します。

このメソッドは、ユーザーからの入力や外部データソースから取得した情報など、文字列形式で提供される数値を実際の計算に使用したい場合に特に役立ちます。戻り値は常にNumber型となり、その値は整数または浮動小数点数となります。

構文(syntax)

1const stringValue = "3.14159です";
2const parsedNumber = Number.parseFloat(stringValue);
3// parsedNumber の値は 3.14159 となります。

引数(parameters)

string

  • string: 解析対象の文字列

戻り値(return)

number

文字列を解析し、浮動小数点数として解釈できる数値を返します。文字列の先頭から数値として解釈できる部分までを抽出し、その数値を返します。数値として解釈できない場合はNaNを返します。

関連コンテンツ