Course contentsShow
← Java
Lesson 1898 of 2,87038. Date and Time API (java.time)Free lesson

Converting Legacy Date Strings with SimpleDateFormat

Reading dates formatted by SimpleDateFormat and parsing them with DateTimeFormatter instead.

Converting Legacy Date Strings with SimpleDateFormat

What you'll learn: How to modernize date parsing by reading old SimpleDateFormat-formatted strings and converting them using the modern DateTimeFormatter API.

When maintaining legacy code, you'll often encounter date strings formatted by SimpleDateFormat. Rather than continuing to use the old, problematic API, you can parse these strings with the modern java.time classes for safer, clearer code.

The Migration Strategy

The key insight: pattern compatibility. Most SimpleDateFormat patterns work directly with DateTimeFormatter. You can read what pattern the legacy code used and apply the same pattern to DateTimeFormatter.ofPattern().

Here's how it works:

// Legacy code that formatted dates
SimpleDateFormat oldFormatter = new SimpleDateFormat("MM/dd/yyyy");
String legacyDateString = "12/25/2023";

// Modern parsing approach
DateTimeFormatter newFormatter = DateTimeFormatter.ofPattern("MM/dd/yyyy");
LocalDate modernDate = LocalDate.parse(legacyDateString, newFormatter);

System.out.println(modernDate); // 2023-12-25

Pattern Translation

Most patterns translate directly:

  • "yyyy-MM-dd" → remains "yyyy-MM-dd"
  • "MM/dd/yyyy HH:mm:ss" → remains "MM/dd/yyyy HH:mm:ss"

The pattern symbols are largely compatible between the two APIs, making migration straightforward.

Choosing the Right Target Type

Match your target temporal type to what the string contains:

  • Date only ("12/25/2023") → parse to LocalDate
  • Time only ("14:30:00") → parse to LocalTime
  • Date and time ("12/25/2023 14:30") → parse to LocalDateTime

Key Takeaway: You can directly reuse most SimpleDateFormat patterns with DateTimeFormatter.ofPattern(), parsing legacy date strings into modern java.time objects without changing the format itself—just the parsing mechanism.