toFixed

Summary

The toFixed() method formats a number to fixed-point notation (decimal).

Syntax

toFixed([ fractionDigits ])

fractionDigits: Optional. The number of digits after the decimal point. Must be in the range 0 - 20, inclusive. Defaults to 0.

Return Value

Returns a string representation of a number in fixed-point notation, containing fractionDigits digits after the decimal point.

If fractionDigits is not supplied or undefined , the default value is 0.

Examples

Using toFixed to format the decimal presentation of a number.

var pie = 3.14159;

// output a number without decimal digits
pie.toFixed(0);
// Returns: "3"

// decimal digits are rounded if necessary
pie.toFixed(4);
// Returns: "3.1416"

// missing decimal digits are added
pie.toFixed(10);
// Returns: "3.1415900000"

// Watch out for number range
(1.23e+20).toFixed(2);
// Returns: "123000000000000000000.00"
(1.23e-10).toFixed(2);
// Returns: "0.00"

// Watch out for operator precedence
-3.1415.toFixed(2);
// Returns: -3.14
(-3.1415).toFixed(2);
// Returns: "-3.14"

Remarks

Throws

RangeError when a fractionDigits outside the bounds of 0 - 20 (inclusive) was given.

Notes

toFixed(3.9) will be treated as toFixed(3).
If number is greater than 1e+21, toFixed() calls toString() internally and returns a string in exponential notation.

Attributions

Microsoft Developer Network: Article