toFixedメソッド

広告

toFixedメソッドは対象のNumberクラスのオブジェクトを文字列に変換する場合に、小数点以下の桁数を指定して変換した値を返します。 

toFixed(int)

Numberクラスのオブジェクトの文字列表現を返します。小数点以下の桁数が引
数に指定した桁数になるように必要に応じて四捨五入を行ったり0で埋めます。

パラメータ:
  int  小数点以下の桁数
戻り値:
  Numberクラスのオブジェクトが表す数値の文字列表現
例外：
  RangeError  小数点以下の桁数に範囲を超えた数値を指定した場合

Numberクラスのオブジェクトが表す数値を文字列に変換した結果を返します。この時、小数点以下の桁数を引数で指定した数値にします。

対象のオブジェクトが表す数値の小数点以下の桁数が指定した桁数よりも大きい場合には、指定した桁数の次の位置で四捨五入を行います。 

対象の数値  1234.543

toFixed(0) --> 1235
toFixed(1) --> 1234.5
toFixed(2) --> 1234.54

小数点以下の桁数に0を指定した場合、小数点以下1位の数値を四捨五入します。この場合、小数点以下1位の数値が5なので結果は1235となります。小数点以下の桁数に1を指定した場合、小数点以下2位の数値を四捨五入します。この場合、小数点以下2位の数値が4なので結果は1234.5となります。

対象のオブジェクトが表す数値の小数点以下の桁数が指定した桁数よりも小さい場合には、指定した桁数になるように0で埋めて行きます。 

対象の数値  1234.543

toFixed(3) --> 1234.543
toFixed(4) --> 1234.5430
toFixed(5) --> 1234.54300

次の例を見て下さい。 

var num_obj = new Number(15.784);
var str1 = num_obj.toFixed(0);   // "16"
var str2 = num_obj.toFixed(2);   // "15.78"
var str3 = num_obj.toFixed(4);   // "15.7840"

小数点以下の桁数が指定した桁数になるように変換された文字列を取得できます。

なお小数点以下の桁数にあまり大きな数値を指定するとRangeError例外が発生します。

サンプルコード

では簡単なサンプルで試してみます。 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<meta http-equiv="Content-Script-Type" content="text/javascript">
<title>JavaScript テスト</title>
</head>
<body>

<script type="text/javascript" src="./js/script5_1.js">
</script>

</body>
</html>

function print(str){
  document.write(str + "<br />");
}

document.write("<p>");

var num_obj = new Number(15.784);

print(num_obj.toFixed(0));
print(num_obj.toFixed(1));
print(num_obj.toFixed(2));
print(num_obj.toFixed(3));
print(num_obj.toFixed(4));
print(num_obj.toFixed(5));

try{
  print(num_obj.toFixed(1000));
}catch (e){
  print(e);
}

document.write("</p>");

上記を実際にブラウザ見てみると次のように表示されます。

p5-1

( Written by Tatsuo Ikura )