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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În DateTimeFormatter.ofPattern, fiecare literă din alfabetul englez are un înțeles: y an, M lună, d zi, H oră, m minut, s secundă, E ziua săptămânii și așa mai departe. Literele care nu au un înțeles sunt rezervate, iar când apar, ofPattern aruncă Unknown pattern letter: T și îți spune litera.
Cel mai des e textul pe care vrei să-l afișezi ca atare: T din formatul ISO (2024-05-01T10:30), cuvinte ca „ora” sau „la”. Ca să apară exact cum e scris, textul se pune între apostrofuri: 'T', 'ora'. Pentru un apostrof propriu-zis scrii două: ''.
Atenție: unele litere sunt valide, dar înseamnă altceva decât crezi. mm e minut, MM e lună; hh e ora în format 12 ore, HH în format 24 de ore; D e ziua din an. Acestea nu dau eroare, ci rezultate greșite.
De ce apare: cauzele frecvente
1T din formatul ISO, fără apostrofuri
DateTimeFormatter.ofPattern("yyyy-MM-ddTHH:mm");DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm");
// sau direct: DateTimeFormatter.ISO_LOCAL_DATE_TIMEÎntre apostrofuri, T e text, nu literă de șablon.
2Cuvinte românești în șablon
DateTimeFormatter.ofPattern("dd.MM.yyyy ora HH:mm");DateTimeFormatter.ofPattern("dd.MM.yyyy 'ora' HH:mm");Fiecare literă din „ora” ar fi interpretată ca simbol. Între apostrofuri, cuvântul apare exact.
3Literă inventată pentru dată
DateTimeFormatter.ofPattern("zz.ll.aaaa");DateTimeFormatter.ofPattern("dd.MM.yyyy");Literele de șablon sunt în engleză: d (day), M (month), y (year).
Repară eroarea, direct în pagină
Programul formatează data unei programări în stil ISO, dar se oprește cu IllegalArgumentException: Unknown pattern letter: T. Repară șablonul, ca programul să afișeze Programare: 2024-05-01T10:30.
import java.time.*;
import java.time.format.DateTimeFormatter;
public class Main {
public static void main(String[] args) {
LocalDateTime programare = LocalDateTime.of(2024, 5, 1, 10, 30);
DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-ddTHH:mm");
System.out.println("Programare: " + programare.format(format));
}
}Programare: 2024-05-01T10:30
Indiciu
Pune litera T între apostrofuri în șablon.
Reparația
import java.time.*;
import java.time.format.DateTimeFormatter;
public class Main {
public static void main(String[] args) {
LocalDateTime programare = LocalDateTime.of(2024, 5, 1, 10, 30);
DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm");
System.out.println("Programare: " + programare.format(format));
}
}De ce merge
În șablon, T nu este o literă de dată sau oră, iar ofPattern refuză literele necunoscute. Între apostrofuri, 'T' devine text afișat ca atare, iar restul (yyyy-MM-dd și HH:mm) rămâne interpretat ca an, lună, zi, oră și minut.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Unknown pattern letter: ojava.lang.IllegalArgumentException: Unknown pattern letter: bjava.lang.IllegalArgumentException: Illegal pattern character 'T'java.lang.IllegalArgumentException: Too many pattern letters: d
Cum o eviți pe viitor
- Pune orice text din șablon între apostrofuri:
'T','ora','la'. - Pentru formatul ISO, folosește constantele gata făcute:
DateTimeFormatter.ISO_LOCAL_DATE_TIME. - Ține-ți la îndemână literele de bază:
yyyy MM dd HH mm ss. - Creează formatter-ul o singură dată, ca
static final, și testează-l imediat cu o dată cunoscută.
Întrebări frecvente
Ce e „Illegal pattern character”?
Este mesajul echivalent din SimpleDateFormat, clasa veche de formatare. Reparația e aceeași: textul între apostrofuri.
De ce data mea arată luna în loc de minute?
Probabil ai folosit MM în loc de mm sau invers. Literele mari și mici au înțelesuri diferite și nu dau eroare, ci un rezultat greșit.
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.time.temporal.UnsupportedTemporalTypeException: Unsupported unit: Seconds Ai cerut unui tip de dată o unitate sau un câmp pe care nu-l are: Duration.between pe două LocalDate (fără ore), plus(ore) pe o LocalDate sau HH în formatul unei LocalDate. Folosește ChronoUnit.DAYS.between(a, b) sau Period, ori lucrează cu LocalDateTime. 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. Î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.
