Решение ошибки Illegal pattern character 'T' в Java

Быстрый ответ

Если вам встретилась ошибка с сообщением Неверный символ шаблона 'T', необходимо применить шаблон в соответствии с форматом ISO 8601 к SimpleDateFormat , включив символ 'T' напрямую в паттерн: "yyyy-MM-dd'T'HH:mm:ss". С появлением Java 8 стал доступен java.time.format.DateTimeFormatter, распознающий ISO 8601 без явного указания шаблона.

// Проверенный SimpleDateFormat
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
Date date = sdf.parse("2023-03-30T14:55:00");

// Используем java.time.DateTimeFormatter из Java 8
DateTimeFormatter dtf = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
LocalDateTime ldt = LocalDateTime.parse("2023-03-30T14:55:00", dtf);

Проливаем свет на тайны форматов даты-времени

Разбор строк с датой и временем в Java зачастую напоминает решение головоломки, и здесь залог успеха — в подходящих шаблонах для ваших входных данных. Символ 'T' может иногда вводить в заблуждение, поскольку он является частью стандарта ISO и требует экранирования. Здесь на помощь придет новый API — java.time, который способен автоматически обрабатывать подобные нюансы.

Часовые пояса тоже обернуты тайной. Если входная строка с датой оканчивается на 'Z', то она обозначает UTC. В SimpleDateFormat это записывается как: "yyyy-MM-dd'T'HH:mm:ssXXX", где XXX — это обозначение часового пояса по ISO 8601.

Переходим к java.time (Java 8+)

С версии Java 8 в наше распоряжение пришел современный API для работы с датами и временем, который является крайне рекомендованным к использованию благодаря его отличным неизменяемым и плавным свойствам. Для работы с UTC используйте классы Instant и ZoneId:

// Класс Instant из Java 8 идеально подходит для работы с UTC
Instant instant = Instant.parse("2023-03-30T14:55:00Z");
Date dateFromInstant = Date.from(instant);

При необходимости взаимодействовать со старым API или JDBC, возможно потребуется преобразование данных:

// Преобразуем java.time в java.util.Date
Date oldDate = Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant()); 
Instant newInstant = oldDate.toInstant();

java.time также упрощает работу с часовыми поясами с помощью таких классов, как OffsetDateTime:

OffsetDateTime odt = OffsetDateTime.parse("2023-03-30T14:55:00Z");

Усиливаем надёжность вашего кода лучшими практиками

При разборе дат важно подумать о стабильности вашего кода. Используйте блоки try-catch для обработки возможных исключений и рассмотрите использование Optional<LocalDateTime>, если ваш метод может столкнуться с нестабильными данными.

Визуализация

Вот визуальный способ описания процесса разбора дат со сложным символом 'T':

Поезд (🚂) на рельсах (🛤️):

SimpleDateFormat 🚂 = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
Date travelDate = 🚂.parse("2021-04-08T16:00:00");

🛤️ Ожидаемый формат: yyyy-MM-dd'T'HH:mm:ss
🚂 Специальная машина для разбора даты: она движется только по ожидаемому формату.
🛑 Сложный символ 'T': он может сбить с пути, если не ожидается.

Решение: Необходимо ввести символ 'T' в часть шаблона!

SimpleDateFormat 🚂 = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
// 'T' теперь является частью шаблона!

Завершение

Использование литералов

Нужно учесть букву 'T' для корректного разбора строки с датой: в SimpleDateFormat она указывается в кавычках:

// 'T' должна присутствовать в шаблоне
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");

Интерпретация часового пояса

Завершающий символ 'Z' в строке даты-времени обозначает Zulu-время или UTC. В SimpleDateFormat это учтено как 'XXX':

// 'Z' обозначает Zulu-время, соответствующий шаблон — 'XXX'.
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX");

При использовании java.time часто нет необходимости явно указывать шаблон, так как многие методы работают с ISO 8601 по умолчанию.

Наслаждаемся удобством java.time

С помощью java.time вы легко получите отдельные компоненты даты, например, год, без использования SimpleDateFormat:

// Вам нужен только год?
int year = LocalDateTime.parse("2023-03-30T14:55:00").getYear();

Для версий до Java 8 класс Calendar подойдет для извлечения данных из Date:

// Возвращаемся в прошлое с применением Calendar до Java 8
Calendar calendar = Calendar.getInstance();
calendar.setTime(date);
int year = calendar.get(Calendar.YEAR);

Полезные материалы

1. SimpleDateFormat(Java Platform SE 7) — официальное описание SimpleDateFormat в Java 7.
2. Настройка форматов(Java Tutorial) — руководство по созданию шаблонов форматирования даты и времени в Java.
3. Анализ и форматирование дат (Java Tutorial) — подробное пособие по форматированию дат в Java 8.
4. Java SE 8 Date and Time — детальное изучение библиотеки даты и времени в Java 8.
5. DateTimeFormatter(Java Platform SE 8) — описание DateTimeFormatter в документации Java 8.
6. Java SimpleDateFormat – formatarea datelor în Java | DigitalOcean — полезные советы от DigitalOcean по работе с SimpleDateFormat.