Número

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

Sumário

O objeto JavaScriptNumber é um objeto encapsulado que permite você trabalhar com valores numéricos. Um objetoNumber é criado utilizando o construtorNumber().

Construtor

new Number(value);

Parâmetros

value: O valor numérico do objeto sendo criado.

Descrição

Os principais usos para o objetoNumber são:

Se o objeto não pode ser convertido para um número, é retornadoNaN.
Fora do contexo de um construtor (Ex., Sem o operadornew,Number pode ser utilizador para realizar uma conversão de tipo.

Propriedades

Number.EPSILONExperimental: O menor intervalo entre dois números representáveis.
Number.MAX_SAFE_INTEGERExperimental: O inteiro máximo seguro em JavaScript (253 -1).
Number.MAX_VALUE: O maior número representável positivo.
Number.MIN_SAFE_INTEGERExperimental: O inteiro mínimo seguro em JavaScript (-(253 -1)).
Number.MIN_VALUE: O número mínimo representável positivo - isto é, o número positivo mais próximo de zero (sem ser zero na verdade).
Number.NaN: Valor especial que não é número.
Number.NEGATIVE_INFINITY: Valor especial representando infinito negativo; retornado no "overflow".
Number.POSITIVE_INFINITY: Valor especial representando infinito; retornado no "overflow".
Number.prototype: Permite a adição de propriedades a um objeto Number.

Methods

Number.isNaN()Experimental: Determina se o valor passado é NaN.
Number.isFinite()Experimental: Determina se o tipo e o valor passado é um número finito.
Number.isInteger()Experimental: Determina se o tipo do valor passado é inteiro.
Number.isSafeInteger()Experimental: Determina se o tipo do valor passado é um inteiro seguro (número entre -(253 -1) e 253 -1).
~~Number.toInteger()~~: ~~Usado para avaliar o valor passado e convertê-lo a um inteiro (ou infinito), mas foi removido.~~
Number.parseFloat()Experimental: O valor é o mesmo que parseFloat do objeto global.
Number.parseInt()Experimental: O valor é o mesmo que parseInt do objeto global.

Instâncias`Number`

Toda instânciaNumber herdam deNumber.prototype. O objeto 'prototype' do construtorNumber pode ser modificado para afetar todas as instânciasNumber.

Exemplos

Exemplo: Usando o objeto`Number` para atribuir valores a variáveis numéricas

O seguinte exemplo usa as propriedades do objetoNumber para atribuir valores a várias variáveis numéricas:

var biggestNum = Number.MAX_VALUE;var smallestNum = Number.MIN_VALUE;var infiniteNum = Number.POSITIVE_INFINITY;var negInfiniteNum = Number.NEGATIVE_INFINITY;var notANum = Number.NaN;

Exemplo: Intervalo inteiro para`Number`

O seguinte exemplo mostra os valores inteiros mínimo e máximo que podem ser representados como objetoNumber (para mais detalhes, referir-se ao padrão EcmaScript standard (EcmaScript standard), capítulo8.5 O tipo de número (The Number Type):

var maxInt = 9007199254740992;var minInt = -9007199254740992;

Ao analisar dados que foram serializados para JSON, valores inteiros que caem fora desse intervalo podem ser corrompidos quando o analisador JSON os converte ao tipoNumber. UsandoString em vez disso é uma possível alternativa para se evitar um resultado indesejado.

Exemplo: Usando`Number para converter um objeto Date`

O exemplo a seguir converte o objetoDate para um valor numérico usandoNumber como uma função:

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

Isto resulta em "819199440000".

Converte 'string' numérica em números

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