Number.prototype.toPrecision()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El método toPrecision()
devuelve una cadena que representa un objeto Number
según la precisión especificada.
Pruébalo
Sintaxis
numObj.toPrecision([precision])
Parámetros
precision
-
Opcional. Un entero que especifica el número de digitos significativos.
Valor devuelto
Una cadena que representa un objeto Number
en punto fijo o en notación exponencial redondeada a precision
de digitos significativos. Vea la discusión acerca del redondeo en la descripción del método Number.prototype.toFixed()
, que además aplica a toPrecision()
.
Si el parámetro precision
es omitido, se comporta como Number.prototype.toString()
. Si el parámetro precision
es un valor no entero, el valor es redondeado al entero más cercano.
Exceptions
RangeError
-
If
precision
is not between 1 and 100 (inclusive), aRangeError
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 notación exponencial
console.log((1234.5).toPrecision(2)); // logs '1.2e+3'
Especificaciones
Specification |
---|
ECMAScript Language Specification # sec-number.prototype.toprecision |
Compatibilidad con navegadores
BCD tables only load in the browser