Преобразование строки ISO 8601 в java.util.Date: лучшие практики

Проблема SimpleDateFormat и ISO 8601

Ваша проблема типична для разработчиков, работающих с датами в Java до версии 8. SimpleDateFormat имеет несколько недостатков:

• Не потокобезопасен — может давать неверные результаты при многопоточном использовании
• Плохо обрабатывает часовые пояса, особенно символ 'Z' (обозначение UTC)
• Не поддерживает полный ISO 8601 формат, особенно смещения в формате "+03:00" (с двоеточием)

Символ 'Z' в вашем шаблоне "yyyy-MM-dd'T'HH:mm:ss'Z'" воспринимается как литерал, а не как обозначение часового пояса. Для правильной обработки нужно использовать X или XXX в шаблоне.

Решение с использованием SimpleDateFormat (исправленный вариант)

Для парсинга ISO 8601 строк с UTC (Z) и смещениями можно использовать следующие шаблоны:

// Для строк с 'Z' (UTC)
SimpleDateFormat sdfUTC = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssXXX");
// Но 'Z' не поддерживается напрямую, нужно заменять
String dateString = "2023-10-05T14:30:00Z".replace("Z", "+00:00");

// Универсальный парсер
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssXXX");
Date date = sdf.parse(dateString.replace("Z", "+00:00"));

Лучший способ: Java 8+ Date/Time API

Хотя вы упомянули, что используете старый код, рекомендую рассмотреть java.time API. Даже если вам нужен java.util.Date, можно легко конвертировать:

import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Date;

public class ISO8601Parser {
    
    public static Date parseISO8601(String dateString) {
        // Пробуем разные форматы ISO 8601
        try {
            // С UTC (Z)
            Instant instant = Instant.parse(dateString);
            return Date.from(instant);
        } catch (Exception e) {
            // С пробуем со смещением
        }
        
        try {
            // С часовым поясом (+03:00, -05:00 и т.д.)
            ZonedDateTime zdt = ZonedDateTime.parse(dateString);
            return Date.from(zdt.toInstant());
        } catch (Exception e) {
            // Без часового пояса (локальная дата/время)
        }
        
        try {
            // Локальное время (без зоны) - интерпретируем как UTC
            LocalDateTime ldt = LocalDateTime.parse(dateString, DateTimeFormatter.ISO_LOCAL_DATE_TIME);
            return Date.from(ldt.toInstant(java.time.ZoneOffset.UTC));
        } catch (Exception e) {
            throw new IllegalArgumentException("Неверный формат ISO 8601: " + dateString);
        }
    }
    
    public static void main(String[] args) {
        // Примеры
        String[] testDates = {
            "2023-10-05T14:30:00Z",
            "2023-10-05T17:30:00+03:00",
            "2023-10-05T14:30:00",
            "2023-10-05T14:30:00.123Z"  // с миллисекундами
        };
        
        for (String test : testDates) {
            System.out.println(test + " -> " + parseISO8601(test));
        }
    }
}

Альтернативный вариант: библиотека Joda-Time

Если вы не можете использовать Java 8, отличной альтернативой является Joda-Time (предшественник java.time). Добавьте зависимость в Maven/Gradle:

<dependency>
    <groupId>joda-time</groupId>
    <artifactId>joda-time</artifactId>
    <version>2.12.5</version>
</dependency>

import org.joda.time.DateTime;
import org.joda.time.format.ISODateTimeFormat;
import java.util.Date;

public class JodaParser {
    public static Date parseISO8601(String dateString) {
        DateTime dateTime = ISODateTimeFormat.dateTimeParser().parseDateTime(dateString);
        return dateTime.toDate();
    }
}

Рекомендации

• Мигрируйте на java.time — это современное, потокобезопасное и более гибкое API
• Если нужен java.util.Date для совместимости, используйте конвертацию через Date.from(instant)
• Избегайте SimpleDateFormat в новых проектах — он считается устаревшим
• Для обработки всех вариаций ISO 8601 (с миллисекундами, разными разделителями) используйте DateTimeFormatter.ISO_DATE_TIME или Instant.parse()

Надеюсь, это поможет! Если останутся вопросы — пишите в комментариях.

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;

public class SimpleDateFormatISO {
    public static Date parseISO8601(String dateString) throws Exception {
        // Заменяем Z на +0000 (для совместимости с SimpleDateFormat)
        String normalized = dateString.replace("Z", "+0000");
        
        // Убираем двоеточие в смещении, если оно есть (например, +03:00 -> +0300)
        if (normalized.contains("+") && normalized.lastIndexOf(":") == normalized.length() - 3) {
            int plusIndex = normalized.lastIndexOf("+");
            String prefix = normalized.substring(0, plusIndex);
            String suffix = normalized.substring(plusIndex + 1);
            suffix = suffix.replace(":", "");
            normalized = prefix + "+" + suffix;
        }
        
        // Пробуем разные форматы
        String[] patterns = {
            "yyyy-MM-dd'T'HH:mm:ssX",     // Без миллисекунд
            "yyyy-MM-dd'T'HH:mm:ss.SSSX"  // С миллисекундами
        };
        
        for (String pattern : patterns) {
            try {
                SimpleDateFormat sdf = new SimpleDateFormat(pattern);
                sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
                return sdf.parse(normalized);
            } catch (Exception e) {
                // Пробуем следующий шаблон
            }
        }
        
        throw new IllegalArgumentException("Не удалось распарсить: " + dateString);
    }
}