NumberFormatException is a common error in Java that occurs when the Java Virtual Machine (JVM) is unable to convert a string or other character-based input into a specific type of number, such as an integer or a floating-point number. This error can be frustrating, especially when it occurs unexpectedly. In this article, we will explore the common causes of NumberFormatException in Java and provide practical fixes to help you resolve this issue and write more robust code.
1. NumberFormatException when parsing a string to integer
This error occurs when you attempt to convert a string to an integer using Integer.parseInt() or Integer.valueOf(), but the string is not a valid integer representation.
Why It Happens
This error can occur due to various reasons such as leading or trailing whitespace in the string, non-numeric characters in the string, or the string being empty.
How to Fix It
To fix this error, you should ensure that the string you are attempting to parse is a valid integer representation. You can remove leading or trailing whitespace from the string using the trim() method, and then check if the resulting string starts with a minus sign or contains non-numeric characters. If the string is empty, you can handle this scenario separately.
2. NumberFormatException when parsing a string to float
This error occurs when you attempt to convert a string to a floating-point number using Float.parseFloat() or Float.valueOf(), but the string is not a valid float representation.
Why It Happens
This error can occur due to various reasons such as missing decimal point in the string, non-numeric characters in the string, or the string being empty.
How to Fix It
To fix this error, you should ensure that the string you are attempting to parse is a valid float representation. You can remove leading or trailing whitespace from the string using the trim() method, and then check if the resulting string contains a decimal point. If the string is empty, you can handle this scenario separately.
3. NumberFormatException when using DecimalFormat
This error occurs when you attempt to format a number using DecimalFormat, but the input number is not a valid number representation.
Why It Happens
This error can occur due to various reasons such as non-numeric characters in the input number, or the input number being empty.
How to Fix It
To fix this error, you should ensure that the input number is a valid number representation. You can check if the input number is a valid integer or float representation, and then use DecimalFormat to format the number accordingly.
4. NumberFormatException when using NumberFormat
This error occurs when you attempt to format a number using NumberFormat, but the input number is not a valid number representation.
Why It Happens
This error can occur due to various reasons such as non-numeric characters in the input number, or the input number being empty.
How to Fix It
To fix this error, you should ensure that the input number is a valid number representation. You can check if the input number is a valid integer or float representation, and then use NumberFormat to format the number accordingly.
5. NumberFormatException when using BigDecimal
This error occurs when you attempt to create a BigDecimal object from a string, but the string is not a valid BigDecimal representation.
Why It Happens
This error can occur due to various reasons such as missing decimal point in the string, non-numeric characters in the string, or the string being empty.
How to Fix It
To fix this error, you should ensure that the string you are attempting to parse is a valid BigDecimal representation. You can remove leading or trailing whitespace from the string using the trim() method, and then check if the resulting string contains a decimal point. If the string is empty, you can handle this scenario separately.
6. NumberFormatException when using BigInteger
This error occurs when you attempt to create a BigInteger object from a string, but the string is not a valid BigInteger representation.
Why It Happens
This error can occur due to various reasons such as non-numeric characters in the string, or the string being empty.
How to Fix It
To fix this error, you should ensure that the string you are attempting to parse is a valid BigInteger representation. You can remove leading or trailing whitespace from the string using the trim() method, and then check if the resulting string contains only numeric characters. If the string is empty, you can handle this scenario separately.
7. NumberFormatException when using NumberFormatException to parse a custom object
This error occurs when you attempt to parse a custom object to a number using NumberFormatException, but the object is not a valid number representation.
Why It Happens
This error can occur due to various reasons such as the object being null, or the object not implementing the Number interface.
How to Fix It
To fix this error, you should ensure that the object you are attempting to parse is a valid number representation. You can check if the object is null, and then check if the object implements the Number interface. If the object does not implement the Number interface, you can handle this scenario separately.
Conclusion
In conclusion, NumberFormatException is a common error in Java that can occur due to various reasons such as invalid input, missing decimal points, or non-numeric characters. By understanding the causes of this error and implementing the fixes provided in this article, you can write more robust code and avoid this error in your Java applications.
Explore More Debugging Resources
- [Browse all JAVA errors](/languages/java)
- [Browse errors by type](/error-types)
- [Search all documented errors](/search)
- [Use the Error Explainer](/error-explainer-tool)