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.