...
Eroare Java · Date calendaristice și expresii regulate

java.lang.IllegalArgumentException: Unknown pattern letter: T

Pe scurt

Ș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

Greșit
JAVA
DateTimeFormatter.ofPattern("yyyy-MM-ddTHH:mm");
Corect
JAVA
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

Greșit
JAVA
DateTimeFormatter.ofPattern("dd.MM.yyyy ora HH:mm");
Corect
JAVA
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ă

Greșit
JAVA
DateTimeFormatter.ofPattern("zz.ll.aaaa");
Corect
JAVA
DateTimeFormatter.ofPattern("dd.MM.yyyy");

Literele de șablon sunt în engleză: d (day), M (month), y (year).

Repară tu

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.

Codul care dă eroarea
JAVA
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));
    }
}
După reparație, programul afișează
Programare: 2024-05-01T10:30
Indiciu

Pune litera T între apostrofuri în șablon.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Unknown pattern letter: o
  • java.lang.IllegalArgumentException: Unknown pattern letter: b
  • java.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

← Toate erorile Java

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.