toFixed

toFixed(number x, integer digits) → string string

Returns a string containing the number x* written with exactly *digits digits after the decimal point: toFixed(1.0, 2) returns "1.00", where string gives "1.0".

The number is rounded to the nearest value, and a half rounds away from zero: toFixed(2.5, 0) returns "3" and toFixed(-2.5, 0) returns "-3". Rounding applies to the number as string writes it, so toFixed(1.005, 2) returns "1.01". The result always uses a dot, never scientific notation, and never "-0.00".

toFixed(1.0, 2)          // "1.00"
toFixed(3.14159, 2)      // "3.14"
toFixed(2.999, 2)        // "3.00"
toFixed(0.1 + 0.2, 2)    // "0.30"
toFixed(12345678.9, 2)   // "12345678.90"
toFixed(-0.004, 2)       // "0.00"
toFixed(7, 3)            // "7.000"

(1.0).toFixed(2);      // "1.00"
(3.14159).toFixed(2);  // "3.14"
(1.005).toFixed(2);    // "1.00"
(-0.004).toFixed(2);   // "-0.00"

f"{1.0:.2f}"            # '1.00'
f"{3.14159:.2f}"        # '3.14'
format(1.005, ".2f")    # '1.00'
format(0.125, ".2f")    # '0.12'

Parameters

• x: The number to write, integer or real.
• digits: The number of digits after the decimal point, from 0 to 100. A smaller value counts as 0, a larger one as 100.

Return

• string: The number x* written with exactly *digits decimal places.

Note

• Integers and big integers stay exact, even beyond 2^53. NaN and infinity are written as with string: "NaN", "∞" and "-∞".
• In JavaScript and Python, rounding applies to the exact binary value of the number, hence "1.00" for 1.005. Python also rounds halves to the even digit, and JavaScript switches to scientific notation from 10^21.
• Costs 40 operations, plus 1 per 3 characters produced. See also round and string.