Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

NumberFormatException — fallo al convertir texto en número

NumberFormatException indica que el texto no se puede convertir al tipo numérico solicitado. Con Integer.parseInt, la causa puede ser una notación no válida o un valor fuera del rango de int.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

try {
    int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
    // Handle invalid numeric input.
}

NumberFormatException, de java.lang, indica que ha fallado la conversión de texto a un tipo numérico. Hereda de IllegalArgumentException y es no comprobada: el compilador no exige que se capture ni que se declare en throws.

Para Integer.parseInt(text), la base predeterminada es 10. Se permite un signo inicial + o -, pero los espacios en blanco, el texto vacío y los caracteres que no sean dígitos válidos provocan un error. Incluso una notación numérica válida, como "2147483648", provoca NumberFormatException porque el valor supera el rango de int. En este método, null también provoca esta excepción; no generalices ese comportamiento a todos los métodos de conversión.

Captura NumberFormatException cerca del punto donde se procesan las entradas y gestiona explícitamente el rechazo. No sustituyas el valor por cero sin indicarlo. Elimina los espacios alrededor del texto solo si las reglas de entrada lo permiten; esto no solucionará un valor fuera de rango.

El ejemplo distingue una conversión correcta de dos fallos: un carácter no válido y un valor fuera de rango. Muestra un mensaje propio en lugar de depender del texto del mensaje de la excepción.

Ejemplos

public class Main {
    public static void main(String[] args) {
        String[] inputs = {"42", "12x", "2147483648"};
        for (String text : inputs) {
            try {
                int value = Integer.parseInt(text);
                System.out.println(text + " -> " + value);
            } catch (NumberFormatException e) {
                System.out.println(text + " -> invalid int");
            }
        }
    }
}

Resultado

42 -> 42
12x -> invalid int
2147483648 -> invalid int

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes