java.text.ParseException: Unparseable date: "15/03/2024"
SimpleDateFormat nu a putut citi textul pentru că nu se potrivește cu șablonul dat (alt separator, altă ordine, text în plus). Fă șablonul să corespundă textului ("dd/MM/yyyy" pentru 15/03/2024) sau, în cod nou, folosește LocalDate.parse cu DateTimeFormatter.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
SimpleDateFormat.parse(text) și DateFormat.parse(text) citesc o dată după un șablon. Dacă textul nu se potrivește de la început cu șablonul, aruncă ParseException: Unparseable date și afișează textul primit între ghilimele. Excepția este verificată, așa că trebuie prinsă sau declarată cu throws.
Cauzele uzuale: separatorul diferă (/ față de . sau -), ordinea e alta (yyyy-MM-dd față de dd.MM.yyyy), textul are spații sau litere în plus, ori conține nume de luni în altă limbă decât cea a formatter-ului. Formatul vechi e și permisiv: textul 32.01.2024 nu dă eroare, ci o dată mutată în februarie, dacă nu apelezi setLenient(false).
Mesajul echivalent pentru numere este Unparseable number, de la NumberFormat.parse. Pentru cod nou, java.time (LocalDate.parse) e mai sigur și dă mesaje mai precise.
De ce apare: cauzele frecvente
1Separator diferit de cel din șablon
SimpleDateFormat f = new SimpleDateFormat("dd.MM.yyyy");
Date d = f.parse("15/03/2024");SimpleDateFormat f = new SimpleDateFormat("dd/MM/yyyy");
Date d = f.parse("15/03/2024");Separatorii din șablon trebuie să fie exact cei din text.
2Ordinea câmpurilor e alta
SimpleDateFormat f = new SimpleDateFormat("dd.MM.yyyy");
Date d = f.parse("2024-03-15");SimpleDateFormat f = new SimpleDateFormat("yyyy-MM-dd");
Date d = f.parse("2024-03-15");Textul ISO începe cu anul. Șablonul trebuie să descrie exact forma textului.
3Cod nou scris cu API-ul vechi
Date d = new SimpleDateFormat("dd.MM.yyyy").parse(text);LocalDate d = LocalDate.parse(text, DateTimeFormatter.ofPattern("dd.MM.yyyy"));java.time nu are nevoie de throws, nu e permisiv cu datele invalide și e sigur în aplicații cu mai multe fire.
Repară eroarea, direct în pagină
Programul citește data unei facturi venite dintr-un sistem extern, dar se oprește cu ParseException: Unparseable date: "15/03/2024". Repară șablonul de citire, ca programul să afișeze Factura din: 2024-03-15.
import java.text.*;
import java.util.Date;
public class Main {
public static void main(String[] args) throws ParseException {
SimpleDateFormat citire = new SimpleDateFormat("dd.MM.yyyy");
SimpleDateFormat afisare = new SimpleDateFormat("yyyy-MM-dd");
Date data = citire.parse("15/03/2024");
System.out.println("Factura din: " + afisare.format(data));
}
}Factura din: 2024-03-15
Indiciu
Textul folosește / ca separator: șablonul de citire trebuie să folosească același.
Reparația
import java.text.*;
import java.util.Date;
public class Main {
public static void main(String[] args) throws ParseException {
SimpleDateFormat citire = new SimpleDateFormat("dd/MM/yyyy");
SimpleDateFormat afisare = new SimpleDateFormat("yyyy-MM-dd");
Date data = citire.parse("15/03/2024");
System.out.println("Factura din: " + afisare.format(data));
}
}De ce merge
Șablonul dd.MM.yyyy aștepta un punct după zi, dar textul avea /, deci citirea s-a oprit imediat. Cu dd/MM/yyyy, șablonul descrie exact textul, iar data se citește corect. Formatter-ul de afișare o scrie apoi în formatul ISO, 2024-03-15.
Alte forme ale mesajului
java.text.ParseException: Unparseable date: "2024-01-02"java.text.ParseException: Unparseable number: "lei 12"error: unreported exception ParseException; must be caught or declared to be thrown
Cum o eviți pe viitor
- Scrie șablonul pornind de la un exemplu real de text, caracter cu caracter.
- Apelează
setLenient(false)dacă foloseștiSimpleDateFormat, ca datele imposibile să dea eroare. - Fă
trim()pe textul primit din formulare sau fișiere. - În cod nou, folosește
LocalDateșiDateTimeFormatterdinjava.time. - Nu partaja un
SimpleDateFormatîntre fire: nu e thread-safe.
Întrebări frecvente
De ce SimpleDateFormat acceptă 31.02.2024?
În modul implicit (lenient), mută surplusul în luna următoare și dă 2 martie. Cu setLenient(false), aceeași dată aruncă ParseException.
E aceeași eroare cu DateTimeParseException?
E aceeași problemă, dar din API-uri diferite: ParseException vine de la clasele vechi (SimpleDateFormat), iar DateTimeParseException de la java.time, care e și neverificată.
Erori înrudite
java.time.format.DateTimeParseException: Text '01.02.2024' could not be parsed at index 0 LocalDate.parse (sau LocalDateTime.parse) a primit o dată în alt format decât cel așteptat. Fără formatter, Java acceptă doar formatul ISO: 2024-02-01 (și 2024-02-01T10:30 pentru dată cu oră). Pentru 01.02.2024 folosește DateTimeFormatter.ofPattern("dd.MM.yyyy"). java.lang.IllegalArgumentException: Unknown pattern letter: T Șablonul din DateTimeFormatter.ofPattern conține o literă care nu are sens ca dată sau oră, de obicei un text lipit de șablon (T, ora, h). Pune textul între apostrofuri: "yyyy-MM-dd'T'HH:mm" sau "dd.MM.yyyy 'ora' HH:mm". error: unreported exception Exception; must be caught or declared to be thrown Apelezi o metodă care poate arunca o excepție verificată (checked), iar codul tău nici nu o prinde, nici nu o declară. Pune apelul într-un try/catch sau adaugă throws NumeExceptie la metoda care face apelul. Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
