Number.prototype.toPrecision()

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since julio de 2015.

Learn more
See full compatibility

El mtodo toPrecision() devuelve una cadena que representa un objeto Number segn la precisin especificada.

Prubalo

function precise(x) {
  return x.toPrecision(4);
}

console.log(precise(123.456));
// Expected output: "123.5"

console.log(precise(0.004));
// Expected output: "0.004000"

console.log(precise(1.23e5));
// Expected output: "1.230e+5"

Sintaxis

numObj.toPrecision([precision])

Parmetros

precision: Opcional. Un entero que especifica el nmero de digitos significativos.

Una cadena que representa un objeto Number en punto fijo o en notacin exponencial redondeada a precision de digitos significativos. Vea la discusin acerca del redondeo en la descripcin del mtodo Number.prototype.toFixed() , que adems aplica a toPrecision().

Si el parmetro precision es omitido, se comporta como Number.prototype.toString(). Si el parmetro precision es un valor no entero, el valor es redondeado al entero ms cercano.

Exceptions

RangeError: If precision is not between 1 and 100 (inclusive), a RangeError is thrown. Implementations are allowed to support larger and smaller values as well. ECMA-262 only requires a precision of up to 21 significant digits.

Ejemplos

Usando `toPrecision`

var numObj = 5.123456;

console.log(numObj.toPrecision()); // logs '5.123456'
console.log(numObj.toPrecision(5)); // logs '5.1235'
console.log(numObj.toPrecision(2)); // logs '5.1'
console.log(numObj.toPrecision(1)); // logs '5'

numObj = 0.000123;

console.log(numObj.toPrecision()); // logs '0.000123'
console.log(numObj.toPrecision(5)); // logs '0.00012300'
console.log(numObj.toPrecision(2)); // logs '0.00012'
console.log(numObj.toPrecision(1)); // logs '0.0001'

// observe que bajo algunas circunstancias el valor retornado es en notacin exponencial
console.log((1234.5).toPrecision(2)); // logs '1.2e+3'