CKTIS / JavaScript
Number.prototype.toString(radix): representar un número en una base
Convierte un valor `Number` en texto en una base de 2 a 36. Aprende cómo JavaScript elige y convierte la base y por qué dar formato a un número no equivale a interpretar texto.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
number.toString()
number.toString(radix)Number.prototype.toString(radix) devuelve una cadena sin modificar el número. radix es la base del sistema de numeración: 2 para binario y 16 para hexadecimal. Si omites el argumento o pasas undefined, se usa la base 10. El valor de this debe ser un primitivo Number o un objeto Number; cualquier otro valor, como una cadena, provoca un TypeError.
Según ECMAScript 2024, el argumento proporcionado se convierte a Number. Si el valor es finito, se trunca hacia cero, así que "16.9" selecciona la base 16. Una base fuera del intervalo de 2 a 36, ambos inclusive, provoca un RangeError. Esto incluye null y NaN (que se reducen a cero), así como los valores infinitos. Un argumento de tipo Symbol o BigInt provoca un TypeError durante la conversión.
El resultado usa los dígitos 0–9 seguidos de las minúsculas a–z, sin añadir el prefijo 0b ni 0x. El - inicial es un signo, no una representación en complemento a dos; el punto . separa la parte fraccionaria. Tanto +0 como -0 dan "0"; los valores especiales dan "NaN", "Infinity" y "-Infinity". En base 10 puede usarse notación científica, como "1e+21".
Cambiar de base no recupera la precisión que el valor Number ya haya perdido. El último dígito significativo no siempre queda determinado de forma única, así que no des por hecho que todos los motores devolverán la misma cadena. Si necesitas enteros grandes exactos, usa BigInt desde el principio y llama a BigInt.prototype.toString. parseInt(text, radix) lee el tramo inicial que representa un entero, pero no valida toda la cadena ni recupera fracciones: parseInt("ff!", 16) devuelve 255.
Ejemplos
{
const n = 255;
console.log(n.toString());
console.log(n.toString(2));
console.log(n.toString(16));
console.log(n.toString("16.9"));
console.log((-10.5).toString(2));
console.log(parseInt(n.toString(16), 16));
try {
n.toString(37);
} catch (error) {
console.log(error.name);
}
}Resultado
255 11111111 ff ff -1010.1 255 RangeError
El mismo número se imprime en decimal, binario y hexadecimal. `"16.9"` selecciona la base `16`, el número fraccionario negativo conserva su signo y la base `37` provoca un `RangeError`.
Lecciones relacionadas
- JavaScript · Lección 2 · Avanzado · Versión: 4
- JavaScript · Lección 3 · Avanzado · Versión: 4