Objetivos
Number
O tipo de Number armazena dados números sinalizados e não sinalizados bem como
valores de ponto flutuante. Seu construtor também pode ser utilizado para
conversão de dados.
Instanciando Number
Para declararmos um objeto do tipo Number, utilizamos seu construtor padrão que
recebe um valor como argumento.
Sintaxe
let variavel = new Number( value )
Number(value)
Onde
value: valor passado como argumentos. O novo objeto criado é baseado no value passado.
Se null ou undefined, um objeto vazio será criado.
Retorno
Quando utilizamos o contrutor new Number(value) criamos um objeto do tipo Number.
Quando utilizamos Number(value) um objeto do tipo primitivo será criado.
Exemplo 1
let obj = new Number(100);
let obj = Number(100);
Saída
-
A classe Number possui algumas propriedades que retornam informações sobre
seu tipo de dado. Abaixo, a lista de propriedades:
Propriedade |
Descrição |
|
EPSILON |
- |
- |
MAX_SAFE_INTEGER |
- |
- |
MIN_SAFE_INTEGER |
- |
- |
MAX_VALUE |
Retorna maior valor númerico |
Visitar |
MIN_VALUE |
Retorna o menor valor numérico |
Visitar |
NaN |
Representa o valor Not-a-Number |
Visitar |
NEGATIVE_INFINITY |
Representa -infinito |
- |
POSITIVE_INFINITY |
Representa +infinito |
- |
prototype |
- |
- |
A propriedade estática MAX_VALUE retorna o maior valor numérico possível
em JS.
Sintaxe
Number.MAX_VALUE;
Exemplo 2
console.log(Number.MAX_VALUE);
Saída
1.7976931348623157e+308
A propriedade estática MIN_VALUE retorna o menor valor numérico possível
em JS.
Sintaxe
Number.MIN_VALUE;
Exemplo 3
console.log(Number.MIN_VALUE);
Saída
5e-324
A propriedade NaN representa o valor Not-a-Number. Esse valor é
retornado por métodos relacionados a conversão, checagem de dados e outros.
Sintaxe
Number.NaN;
Exemplo 4
console.log(Number.NaN);
console.log(Number("!@#")); //conversão para number
Saída
NaN
NaN
Os métodos listados abaixo são fornecidos pelo classe Number para manipulação de suas informações.
Método |
Descrição |
|
isFinite(value) |
- |
- |
isInterger |
Verificar se um valor é inteiro |
Visitar |
isNaN |
Verificar se uma valor é NaN |
Visitar |
isSafeInterger(value) |
- |
- |
parseFloat |
Converte uma string para float |
Visitar |
parseInt |
Converte uma string para Inteiro |
Visitar |
toExponencial |
Converte uma valor númerico para exponencial. |
Visitar |
toFixed |
Converte um valor truncando casas decimais |
Visitar |
toLocaleString |
- |
- |
toPrecision |
Converte uma número limitando casas decimais |
Visitar |
toString |
Converte uma valor numérico para string |
Visitar |
valueOf |
Retorna o valor primitivo |
Visitar |
O método isInteger checa se um valor é inteiro ou não. Esse método recebe um valor como argumento e
retorna um booleano.
Sintaxe
Number.isInterger(value);
Onde
value: valor testado.
Retorno
true se é inteiro, false caso contrário.
Exemplo 5
console.log(Number.isInteger(123));
console.log(Number.isInteger("1.99"));
Saída
true
false
O método isNaN checa se um valor é NaN ou não. Esse método recebe um
valor como argumento e retorna um booleano.
Sintaxe
nome_objeto.isNaN(value);
Onde
value: valor a ser testado.
Retorno
true se é NaN, false caso contrário.
Exemplo 6
console.log(Number.isNaN(Number.NaN));
console.log(Number.isNaN("1.99"));
Saída
true
false
O método parseFloat converte um valor contido em uma string para um valor do tipo float. Esse
método recebe um valor como argumento e retorna um valor convertido para float.
Sintaxe
Number.parseFloat(value);
Onde
value: string contendo valor a ser convertido.
Retorno
value convertido para float, ou NaN caso a conversão não seja possível.
Exemplo 7
console.log(Number.parseFloat("1.99"));
console.log(Number.parseFloat("ABC"));
Saída
1.99
NaN
O método parseInt converte um valor contido em uma string para um valor do
tipo inteiro. Esse método recebe um valor como argumento e retorna um inteiro.
Sintaxe
Number.parseInt(value)
Onde
value: string contendo valor a ser convertido.
Retorno
value convertido para inteiro, ou NaN caso a conversão não seja possível.
Exemplo 8
console.log(Number.parseInt("199"));
console.log(Number.parseInt("ABC"));
Saída
1.99
NaN
O método toExponential converte um valor numérico para notação exponencial. Esse método
recebe um valor como argumento e retorna uma string contendo um valor convertido.
Sintaxe
variavel.toExponential();
variavel.toExponential(fractionDigits);
Onde
fractionDigits: número de dígitos da parte fracionária. Opcional.
Retorno
string contendo variavel convertido para exponencial, NaN caso a conversão não seja possível.
Exemplo 9
let x = 1.123456;
console.log(x.toExponential(3));
Saída
1.123e+0
O método toFixed converte um número para string truncando casas decimais.
Esse método recebe um valor como argumento e retorna uma string contendo um valor
convertido.
Sintaxe
Number.toFixed();
Number.toFixed(digits);
Onde
digits: número inteiro que representa o número de casas após a vírgula.
Retorno
string contendo um valor convertido, NaN caso a conversão não seja possível.
Exemplo 10
let x = 1.678;
console.log(x.toFixed(2));
Saída
1.68
Com o método toPrecision podemos recuperar uma string representando um valor
numérico com casas decimais.
Sintaxe
variavel.toPrecision(precision);
variavel.toPrecision();
Onde
precision: número de casas decimais para precisão.
Retorno
Objeto contendo chaves/valores de iteravel como propriedades.
Exemplo 11
let valor = 1.12345689;
console.log(valor.toPrecision());
console.log(valor.toPrecision(4));
console.log(valor.toPrecision(3));
console.log(valor.toPrecision(4));
Saída
1.12345689
1.123
1.12
1.123
O método toString converte um Number para uma string. Esse método não
possui argumentos e retorna um número convertido para string.
Sintaxe
variavel.toString();
Onde
-
Retorno
String contendo variavel convertido para string.
Exemplo 12
let x = 1.698;
console.log(x.toString());
Saída
1.698
O método valueOf retorna o valor primitivo(inteiro, float) de um Number. Esse
método não possui argumentos.
Sintaxe
variavel.valueOf()
Onde
-
Retorno
Valor primitivo.
Exemplo 13
let x = Number(1.698);
console.log(x.valueOf());
Saída
1.698
Histórico de atualizações
- 19/08/2025 - revisão 4 - Ajustes: pontuais e sintaxe; Correção: método 'toPrecision'
- 25/09/2024 - revisão 3 - Ajustes pontuais
- 02/09/2024 - revisão 2 - Correção em links de objetivos
- 06/10/2023 - revisão 1 - Correção navegação, erros gramaticais de descrição de intro sobre métodos
- 31/05/2023 - versão inicial
Os cursos oferecidos nesta página são cursos fornecidos por parceiros. Ao comprar um curso clicando
em seu banner, você está ajudando a manter o projeto TutorialDev vivo. Os sites dos cursos parceiros utilizam cookies.