Number.prototype.toFixed() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

Number.prototype.toFixed()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

toFixed() は Number 値のメソッドで、指定された小数点以下の桁数で固定小数点表記を使用して、これの数値を表す文字列を返します。

試してみましょう

function financial(x) {
  return Number.parseFloat(x).toFixed(2);
}

console.log(financial(123.456));
// 予想される結果: "123.46"

console.log(financial(0.004));
// 予想される結果: "0.00"

console.log(financial("1.23e+5"));
// 予想される結果: "123000.00"

構文

js
toFixed()
toFixed(digits)

引数

digits 省略可

小数点の後に現れる桁の数です。これは 0 以上 100 以下の値です。この引数が省略されると、0 として扱われます。

返値

指定された数値を固定小数点表記で表します。数値の大きさ（符号を無視）が 1021 以上の場合、科学記数法を使用します（Number.prototype.toString() と同じ返値）。

例外

RangeError

digits が 0 以上 100 以下ではない場合に発生します。

TypeError

このメソッドが Number ではないオブジェクト上で実行された場合に発生します。

解説

toFixed() メソッドは、指数表記を使用せずに、小数点以下の桁数が正確に digits 桁である数値の文字列表現を返します。必要に応じて数値は丸められ、小数点以下の桁数が指定された長さに合わせるために必要に応じてゼロで埋められます。

数値の絶対値が 1e+21 以上の場合は、このメソッドは単純に Number.prototype.toString() を呼び出し、指数表記での文字列を返します。toFixed() は数値が有限数でない場合、"Infinity"、"NaN"、"-Infinity" の何れかを返します。

toFixed() の出力は、一部の値では toString() よりも正確かもしれませんが、これは toString() が隣の数値と区別できる程度の有効数字しか出力しないためです。例えば、次のようになります。

js
(1000000000000000128).toString(); // '1000000000000000100'
(1000000000000000128).toFixed(0); // '1000000000000000128'

しかし、高すぎる digits の精度を選ぶと、10 進数の小数を浮動小数点で正確に表せないため、予期せぬ結果を返すことがあります。例えば次のようになります。

(0.3).toFixed(50); // '0.29999999999999998889776975374843459576368331909180'

例

toFixed() の使用

js
const numObj = 12345.6789;

numObj.toFixed(); // '12346'。四捨五入され小数部がなくなる
numObj.toFixed(1); // '12345.7' を返す。切り上げ
numObj.toFixed(6); // '12345.678900'を返す。0 を追加
(1.23e20).toFixed(2); // '123000000000000000000.00'
(1.23e-10).toFixed(2); // '0.00'
(2.34).toFixed(1); // '2.3'
(2.35).toFixed(1); // '2.4'。切り上げ
(2.55).toFixed(1); // '2.5'
// 浮動小数点数で正確に表せず、最も近い浮動小数点数の
// 方が低いため、切り捨てられる。
(2.449999999999999999).toFixed(1); // '2.5'
// 2.45 との差が Number.EPSILON 未満なので、切り上げ
// このリテラルは、実際には 2.45 と同じ数値をエンコードしている

(6.02 * 10 ** 23).toFixed(50); // '6.019999999999999e+23'; 巨大な数値は指数表記を使用

toFixed() を負の数に使用

メンバーアクセスは単項マイナスよりも優先順位が高いので、文字列を取得するためには負の数の式全体をグループ化する必要があります。

js
-2.34.toFixed(1); // -2.3; 数値
(-2.34).toFixed(1); // '-2.3'

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-number.prototype.tofixed

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年8月28日 by MDN contributors.

View this page on GitHub • Report a problem with this content