parseFloat()

Experimente

function circumference(r) {
  return parseFloat(r) * 2.0 * Math.PI;
}

console.log(circumference(4.567));
// Expected output: 28.695307297889173

console.log(circumference("4.567abcdefgh"));
// Expected output: 28.695307297889173

console.log(circumference("abcdefgh"));
// Expected output: NaN

Sintaxe

parseFloat(string);

Parmetros

string

O valor para analisar. Se este argumento no uma string, ento ele convertido para uma, usando a operao abstrata ToString. Espaos em branco so ignorados.

Retorna

Um nmero de ponto flutuante da string dada. Ou NaN quando o primeiro carcter, diferente de um espao em branco, no pde ser convertido para um nmero

Descrio

parseFloat uma funo top-level e no est associada a nenhum objeto.

parseFloat analisa um argumento string, e retorna um numero de ponto flutuante. Se ele encontrar um carcter diferente de um sinal (+ ou -), numeral (0-9), um ponto decimal, ou um expoente, ele retorna o valor at esse ponto e ignora esse caractere e todos os caracteres seguintes. Espaos a direita e a esquerda so permitidos.

Se o primeiro carcter no puder ser convertido para um nmero, parseFloat retorna NaN.

Para propsitos aritmticos, o valor NaN no um nmero de qualquer raiz. Voc pode chamar a funo isNaN para determinar se o resultado do parseFloat NaN. Se NaN for passado em operaes aritmticas, a operao tambm retornar NaN.

parseFloat tambm pode analisar e retornar o valor Infinity. Voc pode usar a funo isFinite para determinar se a funo um nmero finito (not Infinity, -Infinity, ou NaN).

Exemplos

parseFloat retornando um nmero

O exemplo a seguir sempre retorna 3.14:

parseFloat("3.14");
parseFloat("314e-2");
parseFloat("0.0314E+2");
parseFloat("3.14more non-digit characters");

parseFloat retornando NaN

O exemplo a seguir retorna NaN

parseFloat("FF2");

Uma funo de anlise estrita

As vezes til ter uma maneira mais rigorosa para analisar valores float, expresses regulares podem ajudar:

var filterFloat = function (value) {
  if (/^(\-|\+)?([0-9]+(\.[0-9]+)?|Infinity)$/.test(value))
    return Number(value);
  return NaN;
};

console.log(filterFloat("421")); // 421
console.log(filterFloat("-421")); // -421
console.log(filterFloat("+421")); // 421
console.log(filterFloat("Infinity")); // Infinity
console.log(filterFloat("1.61803398875")); // 1.61803398875
console.log(filterFloat("421e+0")); // NaN
console.log(filterFloat("421hop")); // NaN
console.log(filterFloat("hop1.61803398875")); // NaN

Observe que este cdigo somente um exemplo; ele no aceita nmeros vlidos, tais como 1. ou 0,5.

Especificaes

Compatibilidade

Veja tambm

• parseInt()
• Number.parseFloat()
• Number.parseInt()
• isNaN()