Dokumentacja języka JavaScript 1.5:Obiekty:Number:toFixed

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści 1 Podsumowanie 2 Składnia 3 Parametr 4 Zwraca 5 Wyrzuca 6 Przykłady 7 Zobacz także

[edytuj] Podsumowanie

Formatuje liczbę stosując notację stałoprzecinkową.

Metoda obiektu: Number
Zaimplementowana w:	JavaScript 1.5
Wersja ECMA:	ECMA-262

[edytuj] Składnia

number.toFixed( [digits] )

[edytuj] Parametr

digits

Liczba cyfr, które mają zostać wyświetlone po kropce dziesiętnej; może to być wartość z zakresu od 0 do 20 włącznie, ale implementacje mogą opcjonalnie wprowadzać większe zakresy. Jeśli argument zostanie pominięty, przyjmowana jest wartość 0.

[edytuj] Zwraca

Reprezentację wartości number w postaci łańcucha znaków, która nie stosuje notacji wykładniczej i posiada dokładnie tyle cyfr po separatorze dziesiętnym, ile wskazuje na to wartość parametru digits. Liczba w razie konieczności jest zaokrąglana, a część ułamkowa wypełniana zerami, aby liczba posiadała określoną długość. Jeśli liczba number jest większa niż 1e+21, metoda ta po prostu wywołuje Number.toString() i zwraca łańcuch znaków w notacji wykładniczej.

[edytuj] Wyrzuca

RangeError

Jeśli wartość parametru digits jest za duża lub za mała. Wartości z zakresu od 0 do 20 włącznie nie spowodują wystąpienia RangeError. Dopuszcza się na obsługę mniejszych lub większych wartości przez różne implementacje.

TypeError

Jeśli ta metoda jest przywołana w obiekcie, który nie jest obiektem Number.

[edytuj] Przykłady

var n = 12345.6789;

n.toFixed();              // zwraca 12346: zauważ zaokrąglenie i brak części ułamkowej

n.toFixed(1);             // zwraca 12345.7: zauważ zaokrąglenie

n.toFixed(6);             // zwraca 12345.678900: zauważ dodane zera

(1.23e+20).toFixed(2);    // zwraca 123000000000000000000.00

(1.23e-10).toFixed(2)     // zwraca 0.00

[edytuj] Zobacz także

Number.toExponential(), Number.toLocaleString(), Number.toPrecision(), Number.toString(), Number.toSource(), Number.valueOf()