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 July 2015.

Sumário

O objeto JavaScript Number é um objeto encapsulado que permite você trabalhar com valores numéricos. Um objeto Number é criado utilizando o construtor Number().

Construtor

new Number(value);

Parâmetros

value

O valor numérico do objeto sendo criado.

Descrição

Os principais usos para o objeto Number são:

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

Propriedades

Number.EPSILON Experimental

O menor intervalo entre dois números representáveis.

Number.MAX_SAFE_INTEGER Experimental

O inteiro máximo seguro em JavaScript (253 -1).

Number.MAX_VALUE

O maior número representável positivo.

Number.MIN_SAFE_INTEGER Experimental

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ância Number herdam de Number.prototype. O objeto 'prototype' do construtor Number pode ser modificado para afetar todas as instâncias Number.

Métodos

Exemplos

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

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

js
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 objeto Number (para mais detalhes, referir-se ao padrão EcmaScript standard (EcmaScript standard), capítulo 8.5 O tipo de número (The Number Type):

js
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 tipo Number. Usando String 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 objeto Date para um valor numérico usando Number como uma função:

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

Isto resulta em "819199440000".

Converte 'string' numérica em números

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

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-number-objects

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Number
EPSILON
MAX_SAFE_INTEGER
MAX_VALUE
MIN_SAFE_INTEGER
MIN_VALUE
NEGATIVE_INFINITY
NaN
Number() constructor
POSITIVE_INFINITY
isFinite
isInteger
isNaN
isSafeInteger
parseFloat
parseInt
toExponential
toFixed
toLocaleString
locales parameter
options parameter
toPrecision
toString
valueOf

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
See implementation notes.
Has more compatibility info.

Veja também