CKTIS / JavaScript
Number.prototype.toPrecision: cyfry znaczące
toPrecision zwraca tekst z żądaną liczbą cyfr znaczących, dobierając zapis stały albo wykładniczy.
Wersja: ECMAScript 3 onward; example target: Node.js 24.22.2
Składnia
number.toPrecision(precision)number.toPrecision(precision) formatuje wartość z precision cyframi znaczącymi. Jeśli argument jest pominięty lub ma wartość undefined, metoda od razu zwraca zwykły ToString liczby. Podany argument przechodzi ToIntegerOrInfinity: część ułamkowa jest obcinana w stronę zera, a NaN staje się 0; dla skończonego odbiorcy wynik poza zakresem 1..100 powoduje RangeError.
Po konwersji podanego argumentu odbiorca NaN lub ±Infinity zwraca zwykły tekst jeszcze przed sprawdzeniem zakresu, dlatego Infinity.toPrecision(0) daje "Infinity". Obiekt przekazany jako precision może jednak rzucić podczas konwersji. Dla wartości skończonej metoda używa zapisu wykładniczego, gdy wykładnik dziesiętny jest mniejszy niż -6 albo nie mniejszy niż precision; w przeciwnym razie używa zapisu stałego. Zaokrągla do najbliższego wyniku, a przy remisie po oddzieleniu znaku wybiera większą wartość bezwzględną.
Metoda istnieje od ECMAScript 3, nie jest generyczna i dla odbiorcy innego niż Number lub opakowany Number rzuca TypeError. Zwraca tekst, nie liczbę. Number ma zapis binarny, więc zaokrąglenie może zaskakiwać; do prezentacji lokalnej użyj Intl.NumberFormat.
Przykłady
console.log((1234.5).toPrecision(4), (1234.5).toPrecision(3));
console.log((0.0000012345).toPrecision(3), (0.00000012345).toPrecision(3));
console.log((7).toPrecision(), (-0).toPrecision(3));
console.log(Infinity.toPrecision(0));
try { console.log((1).toPrecision(0)); } catch (error) { console.log(error.name); }
try { Number.prototype.toPrecision.call("1", 2); } catch (error) { console.log(error.name); }Wynik
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
Przykład porównuje zapis stały i wykładniczy oraz pokazuje -0, Infinity i błędy zakresu/odbiorcy.