toFixed

> Funções

Retorna uma string com o número x* escrito com exatamente *digits dígitos após o ponto decimal: toFixed(1.0, 2) retorna "1.00", enquanto string dá "1.0".

O número é arredondado para o valor mais próximo, e uma metade se afasta do zero: toFixed(2.5, 0) retorna "3" e toFixed(-2.5, 0) retorna "-3". O arredondamento se aplica ao número tal como string o escreve, por isso toFixed(1.005, 2) retorna "1.01". O resultado sempre usa um ponto, nunca notação científica e nunca "-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'

Parâmetros

x : O número a escrever, inteiro ou real.
digits : O número de dígitos após o ponto decimal, de 0 a 100. Um valor menor conta como 0, um maior como 100.

Retorno

string : O número x* escrito com exatamente *digits casas decimais.

Note

Inteiros e inteiros grandes permanecem exatos, mesmo além de 2^53. NaN e o infinito são escritos como com string: "NaN", "∞" e "-∞".
Em JavaScript e em Python, o arredondamento se aplica ao valor binário exato do número, daí "1.00" para 1.005. Além disso, o Python desempata as metades para o dígito par, e o JavaScript passa para notação científica a partir de 10^21.
Custa 40 operações, mais 1 a cada 3 caracteres produzidos. Veja também round e string.