ParseException in Java

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

In this article, we will learn what is ParseException in Java, its common causes, example, solutions and best practices.

 
ParseException is a checked exception in Java and is a member of java.text package. It signals that an error has been reached unexpectedly while parsing. This usually happens when a string fails to match a required format or pattern. 

ParseException Class Diagram

Java ParseException Example

In this example, we use DateFormat.parse(String source) method which throws a ParseException object.

This parse() method throws ParseException - if the beginning of the specified string cannot be parsed.

Here is a complete code to throw a ParseException exception:

package com.javaguides.corejava;

import java.text.DateFormat;

import java.text.ParseException;
import java.text.SimpleDateFormat;

public class ParseExceptionExample {

    public static void main(String[] args) {

        DateFormat format = new SimpleDateFormat("MM, dd, yyyy");

        try {
            format.parse("01, , 2010");
        } catch (ParseException e) {
            System.err.println("ParseException caught!");
            e.printStackTrace();
        }
    }
}

Output:

ParseException caught!
java.text.ParseException: Unparseable date: "01, , 2010"
 at java.text.DateFormat.parse(DateFormat.java:366)
 at com.javaguides.corejava.ParseExceptionExample.main(ParseExceptionExample.java:15)

Common Causes

Mismatched Formats: Parsing a string that doesn't match the expected format, like in the date example above. 

Unrecognized Symbols: When the string contains characters or symbols that the parser does not recognize. 

Invalid Data: Parsing a logically incorrect value (e.g., 13th month, as seen in the example). 

Solutions and Best Practices 

1. Input Validation 

Before attempting to parse, ensure the input string broadly matches the expected format. This might involve simple checks like verifying the length of a string or using regular expressions for more complex validations. 

2. Detailed Error Messages 

When catching a ParseException, you can access its message to get detailed information about the nature of the error. This can be extremely helpful for debugging or providing feedback to the user. 

3. Alternative Parsing Strategies 

In some scenarios, instead of relying on a single strict format, you might consider using multiple parsers in a chain, attempting to parse with each one until successful. 

4. Use Third-party Libraries 

There are numerous Java libraries that offer enhanced parsing capabilities, often with better error messages and flexible parsing strategies. For date and time parsing, the java.time package (introduced in Java 8) offers superior capabilities compared to the older SimpleDateFormat. 

5. Graceful Fallback 

In some cases, if a string can't be parsed, it might be appropriate to either provide a default value or to ask the user for clarification. 

Related Exceptions Posts

Java built-in checked exceptions:

• FileNotFoundException
• EOFException
• ClassNotFoundException
• SQLException
• NoSuchMethodException
• InterruptedException

Java built-in unchecked exceptions:

• NullPointerException
• ArrayIndexOutOfBoundsException
• StringIndexOutOfBoundsException
• ArithmeticException
• IllegalArgumentException
• NumberFormatException
• IllegalStateException
• ClassCastException

Java built-in errors:

• OutOfMemoryError
• StackOverflowError
• NoClassDefFoundError

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF