Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.prototype.toFixed: stałe miejsca dziesiętne

toFixed zwraca tekst stałoprzecinkowy z dokładnie zadaną liczbą cyfr po kropce.

Wersja: ECMAScript 3 onward; example target: Node.js 24.22.2

Składnia

number.toFixed(fractionDigits)

number.toFixed(fractionDigits) zwraca tekst z dokładnie fractionDigits cyframi po kropce; pominięty argument oznacza 0. Argument przechodzi ToIntegerOrInfinity, więc ułamek jest obcinany w stronę zera, NaN daje 0, a -0.5 także prowadzi do zera. Zakres 0..100 jest sprawdzany przed obsługą wartości nieskończonych, dlatego nawet Infinity.toFixed(101) rzuca RangeError.

Dla poprawnej liczby cyfr NaN i ±Infinity zwracają odpowiednio "NaN" i tekst nieskończoności. Gdy wartość bezwzględna jest co najmniej 10**21, metoda używa zwykłego ToString i nie dopisuje miejsc dziesiętnych. W pozostałych przypadkach wybiera najbliższy wynik, a przy remisie po oddzieleniu znaku większą wartość bezwzględną. Ponieważ Number jest binarny, (2.55).toFixed(1) daje "2.5"; -0 traci znak, lecz mała ujemna wartość zaokrąglona do zera może dać np. "-0.00".

Metoda istnieje od ECMAScript 3, nie jest generyczna i dla odbiorcy innego niż Number lub opakowany Number rzuca TypeError. Zwraca tekst, nie liczbę, i nie wykonuje lokalnego formatowania. Do pieniędzy samo toFixed nie usuwa błędów binarnych; przechowuj najmniejszą jednostkę jako liczbę całkowitą lub użyj właściwego typu dziesiętnego.

Przykłady

console.log((12.375).toFixed(2), (2.55).toFixed(1));
console.log((-0).toFixed(2), (-0.0001).toFixed(2));
console.log((1e21).toFixed(2), Infinity.toFixed(2));
try { console.log(Infinity.toFixed(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toFixed.call("1", 2); } catch (error) { console.log(error.name); }

Wynik

12.38 2.5
0.00 -0.00
1e+21 Infinity
RangeError
TypeError

Przykład pokazuje zaokrąglanie, binarną niespodziankę, -0, próg 10**21 i RangeError dla Infinity.

Źródła