Number

Sintaxis

new Number(value);
var a = new Number("123"); // a === 123 es false
var b = Number("123"); // b === 123 es true
a instanceof Number; // es true
b instanceof Number; // es false

Parmetros

valor

El valor numrico de un objeto que est siendo creado.

Descripcin

Los principales usos del objeto Number(valor) son convertir un string u otro valor a uno de tipo numrico; si el argumento no puede ser convertido a un nmero, devuelve NaN.

Literal syntax

123; // one-hundred twenty-three
123.0; // same
123 === 123.0; // true

Function syntax

Number("123"); // retorna el nmero 123
Number("123") === 123; // retorna true

Number("unicorn"); // NaN
Number(undefined); // NaN

Constructor

Number()

Crea un nuevo valor Numrico ( Number value).

Propiedades

Number.EPSILON

El intervalo ms pequeo entre dos nmeros representables

Number.MAX_SAFE_INTEGER

El nmero mximo representable en JavaScript (253 - 1).

Number.MAX_VALUE

El nmero ms grande representable.

Number.MIN_SAFE_INTEGER

El nmero mnimo representable en JavaScript (-(253 - 1)).

Number.MIN_VALUE

El nmero ms pequeo representable - que es el nmero positivo ms cercano a cero (sin llegar a ser cero)-.

Number.NaN

Valor especial "no es nmero" NaN.

Number.NEGATIVE_INFINITY

Valor especial para representar infinitos negativos; retorno de un desborde de pila overflow.

Number.POSITIVE_INFINITY

Valor especial para representar infinitos positivos; retorno de un desborde de pila overflow.

Number

Permite la adicin de propiedades a un objeto Number.

Mtodos

Number.isNaN()

Determina si el valor es NaN.

Number.isFinite()

Determina si el valor es un numero infinito.

Number.isInteger()

Determina si un numero es entero.

Number.isSafeInteger()

Determine si el valor pasado es un entero seguro (nmero entre -(253 - 1) y 253 - 1).

~~Number.toInteger() ~~

~~Se usa para evaluar el valor pasado y convertirlo en un entero (or Infinity), pero ha sido eliminado.~~

Number.parseFloat()

El valor es el mismo que parseFloat () del objeto global.

Number.parseInt()

El valor es el mismo que parseInt() del objeto global.

Instancias Number

Todas las instancias Number heredan de Number. El objeto prototipo del constructor de Number puede modificarse para aceptar a todas las instancias de Number.

Mtodos

Number.prototype.toExponential(fractionDigits)

Devuelve una cadena que representa el nmero en notacin exponencial.

Number.prototype.toFixed(digits)

Devuelve una cadena que representa el nmero en notacin de punto fijo.

Number.prototype.toLocaleString([locales [, options]])

Devuelve una cadena con una representacin sensible al idioma de este nmero. Invalida el mtodo Object.prototype.toLocaleString().

Ejemplos

Ejemplo: Utilizando el objeto Number para asignar valores a variables numricas

El siguiente ejemplo utiliza las propiedades del objeto Number para asignar valores a varias variables numricas:

const masGrandeNum = Number.MAX_VALUE;
const masPequeNum = Number.MIN_VALUE;
const infinitoNum = Number.POSITIVE_INFINITY;
const notInfinitoNum = Number.NEGATIVE_INFINITY;
const noEsNum = Number.NaN;

Intervalo de enteros para Number

El siguiente ejemplo muestra los valores mximos y minimos que pueden ser representados mediante el objeto Number:

Cuando se analizan datos que se han serializado en JSON, se puede esperar que los valores enteros que se encuentran fuera de este rango se corrompan cuando el analizador JSON los coacciona al tipo Number.

Una posible solucin es usar String en su lugar.

Los nmeros ms grandes se pueden representar usando el tipo BigInt.

const biggestInt = Number.MAX_SAFE_INTEGER; //  (253 - 1) =>  9007199254740991
const smallestInt = Number.MIN_SAFE_INTEGER; // -(253 - 1) => -9007199254740991

Ejemplo: Utilizando el objeto Number para modificar todos los objetos Number

El siguiente ejemplo crea un objeto Number, miNmero, luego aade la propiedad descripcin a todos los objetos Number. Luego el valor es asignado a la propiedad descripcin del objeto miNmero.

miNmero = new Number(65);
Number.prototype.descripcin = null;
miNmero.descripcin = "velocidad del viento";

Utilizando el objecto Number para transformar un objeto Date

El siguiente ejemplo convierte el objeto Date a un valor numrico usando Number como funcin:

var d = new Date("December 17, 1995 03:24:00");
console.log(Number(d));

Esto muestra "819199440000".

Convierte cadenas numricas a nmeros

Number("123"); // 123
Number("12.3"); // 12.3
Number("123e-1"); // 12.3
Number(""); // 0
Number("0x11"); // 17
Number("0b11"); // 3
Number("0o11"); // 9
Number("foo"); // NaN
Number("100a"); // NaN

Number("-Infinity"); //-Infinity

Vea Tambin

• NaN
• Math
• Arithmetic operators