Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Number.prototype.toPrecision: dígitos significativos

toPrecision devuelve texto con la cantidad solicitada de dígitos significativos, en notación fija o exponencial.

Versión: ECMAScript 3 onward; example target: Node.js 24.22.2

Sintaxis

number.toPrecision(precision)

number.toPrecision(precision) formatea el valor con precision dígitos significativos. Si se omite el argumento o es undefined, el método devuelve de inmediato el resultado ToString normal del número. Un argumento proporcionado pasa por ToIntegerOrInfinity: la fracción se trunca hacia cero y NaN se vuelve 0; para un receptor finito, un resultado fuera de 1..100 lanza RangeError.

Después de convertir un argumento proporcionado, un receptor NaN o ±Infinity devuelve su texto normal antes de comprobar el rango, por lo que Infinity.toPrecision(0) da "Infinity". Sin embargo, un objeto usado como precision puede lanzar durante la conversión. Para un valor finito se usa notación exponencial si el exponente decimal es menor que -6 o al menos precision; en otro caso se usa notación fija. Se redondea al resultado más cercano y, en empate tras separar el signo, a la mayor magnitud.

El método existe desde ECMAScript 3, no es genérico y lanza TypeError si el receptor no es Number ni un Number envuelto. Devuelve texto, no un número. Number usa representación binaria y el redondeo puede sorprender; usa Intl.NumberFormat para presentación local.

Ejemplos

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

Resultado

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

El ejemplo compara notación fija y exponencial y muestra -0, Infinity y errores de rango/receptor.

Fuentes