parseFloat()

Baseline Widely available

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

La función parseFloat() analiza un argumento (si es necesario, lo convierte en una cadena) y devuelve un número de coma flotante.

Pruébalo

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

La cadena que representa al valor que se desea convertir. Si este argumento no es una cadena, entonces, será convertida en una usando la operación abstracta ToString. Se ignora el espacio en blanco inicial en este argumento.

Valor de retorno

Un número de coma flotante analizado a partir de la cadena dada.

O NaN cuando el primer carácter que no es un espacio en blanco no se puede convertir en un número.

Descripción

parseFloat es una propiedad de función del objeto global.

Si parseFloat encuentra un carácter que no sea un signo más (+), signo menos (- U+002D HYPHEN-MINUS), numeral (0 - 9), punto decimal (.) o exponente (e o E), devuelve el valor hasta ese carácter, ignorando el carácter inválido y los caracteres que le siguen.
Un segundo decimal también detiene el análisis (caracteres hasta ese punto se seguirá analizando).
Se ignoran los espacios iniciales y finales en el argumento.
Si el primer carácter del argumento no se puede convertir en un número (no es ninguno de los caracteres anteriores), parseFloat devuelve NaN
parseFloat también puede analizar y devolver Infinity.
parseFloat convierte la sintasis BigInt a Numbers, perdiendo precisión. Esto sucede por que se descarta el carácter n final.

Considera Number(value) para un análisis más estricto, que se convierte en NaN para argumentos con caracteres no válidos en cualquier lugar.

Ejemplos

parseFloat devolviendo un número

Todos los siguientes ejemplos devuelven 3.14:

js
parseFloat(3.14);
parseFloat("3.14");
parseFloat("  3.14  ");
parseFloat("314e-2");
parseFloat("0.0314E+2");
parseFloat("3.14some non-digit characters");
parseFloat({
  toString: function () {
    return "3.14";
  },
});

parseFloat devolviendo NaN

El siguiente ejemplo devuelve NaN:

parseFloat("FF2");

parseFloat y BigInt

Los siguientes ejemplos devuelven 900719925474099300, perdiendo precisión como el entero es demasiado grande para ser representado como un decimal:

js
parseFloat(900719925474099267n);
parseFloat("900719925474099267n");

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 11 feb 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

parseFloat()

In this article

Pruébalo

Sintaxis

Parámetros