Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Number.prototype.toPrecision: cifre significative

toPrecision restituisce testo con il numero richiesto di cifre significative, scegliendo notazione fissa o esponenziale.

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

Sintassi

number.toPrecision(precision)

number.toPrecision(precision) formatta il valore con precision cifre significative. Se l’argomento è omesso o vale undefined, il metodo restituisce subito il normale risultato ToString del numero. Un argomento fornito passa per ToIntegerOrInfinity: la parte frazionaria è troncata verso zero e NaN diventa 0; per un ricevente finito, un risultato fuori da 1..100 genera RangeError.

Dopo la conversione di un argomento fornito, un ricevente NaN o ±Infinity restituisce il testo normale prima del controllo dell’intervallo, quindi Infinity.toPrecision(0) dà "Infinity". Un oggetto passato come precision può comunque generare un’eccezione durante la conversione. Per un valore finito si usa la notazione esponenziale se l’esponente decimale è minore di -6 o almeno precision; altrimenti quella fissa. L’arrotondamento sceglie il risultato più vicino e, a parità dopo aver separato il segno, la magnitudine maggiore.

Il metodo esiste da ECMAScript 3, non è generico e genera TypeError se il ricevente non è Number né un Number boxed. Restituisce testo, non un numero. Number è rappresentato in binario, quindi l’arrotondamento può sorprendere; usa Intl.NumberFormat per la presentazione locale.

Esempi

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

Risultato

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

L’esempio confronta notazione fissa ed esponenziale e mostra -0, Infinity ed errori di intervallo/ricevente.

Fonti