База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Number.prototype.toPrecision: значещи цифри

toPrecision връща текст с поискания брой значещи цифри във фиксиран или експоненциален запис.

Версия: ECMAScript 3 onward; example target: Node.js 24.22.2

Синтаксис

number.toPrecision(precision)

number.toPrecision(precision) форматира стойността с precision значещи цифри. Ако аргументът е пропуснат или е undefined, методът веднага връща обикновения ToString резултат на числото. Подаден аргумент минава през ToIntegerOrInfinity: дробната част се отрязва към нула, а NaN става 0; при краен receiver резултат извън 1..100 хвърля RangeError.

След преобразуване на подадения аргумент receiver NaN или ±Infinity връща обикновения си текст преди проверката на диапазона, затова Infinity.toPrecision(0) дава "Infinity". Обект, подаден като precision, все пак може да хвърли при преобразуването. За крайна стойност се използва експоненциален запис, ако десетичният експонент е по-малък от -6 или поне precision; иначе се използва фиксиран запис. Закръгля се до най-близкия резултат, а при равенство след отделяне на знака — до по-голямата абсолютна стойност.

Методът съществува от ECMAScript 3, не е generic и хвърля TypeError, ако receiver не е Number или boxed Number. Връща текст, не число. Number има двоично представяне, затова закръглянето може да изненада; за локално представяне използвай Intl.NumberFormat.

Примери

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); }

Резултат

1235 1.23e+3
0.00000123 1.23e-7
7 0.00
Infinity
RangeError
TypeError

Примерът сравнява фиксиран и експоненциален запис и показва -0, Infinity и грешки за диапазон/receiver.

Източници