为何Java 8 DateTimeFormatter.ISO_DATE_TIME不支持ISO标准的4种偏移格式？

ISO 8601标准定义了4种时区偏移格式：

• <time>Z：UTC时区标记
• <time>±hh:mm：带冒号的小时分钟偏移
• <time>±hhmm：不带冒号的小时分钟偏移
• <time>±hh：仅小时的偏移

但Java 8中的DateTimeFormatter.ISO_DATE_TIME无法解析不带冒号的偏移格式（例如2022-03-17T23:00:00.000+0000），以下是复现问题的代码示例：

DateTimeFormatter formatter = new DateTimeFormatterBuilder()
    // 拼接ISO标准日期时间格式
    .append(DateTimeFormatter.ISO_DATE_TIME)
    .toFormatter();

// 第一个示例无法解析，会抛出DateTimeParseException
System.out.println(OffsetDateTime.parse("2022-03-17T23:00:00.000+0000", formatter));
System.out.println(OffsetDateTime.parse("2022-03-17T23:00:00.000+00", formatter));
System.out.println(OffsetDateTime.parse("2022-03-17T23:00:00.000+00:00", formatter));
System.out.println(OffsetDateTime.parse("2022-03-17T23:00:00.000Z", formatter));

原因解析 #

结合Java 8官方文档的内容，核心原因如下：

1. DateTimeFormatter.ISO_DATE_TIME的格式定义

该格式化器遵循ISO-8601日期时间规范，固定格式为yyyy-MM-dd'T'HH:mm:ss.SSSXXX。其中XXX仅匹配带冒号的时区偏移（如+00:00）或Z标记，并未包含不带冒号的±hhmm或仅小时的±hh格式。

2. 时区偏移的标准化设计
   从ZoneOffset.getId()的文档可知：

ZoneOffset的ID会以标准化格式输出：Z代表UTC；对于偏移量，输出格式为±hh:mm（或秒级偏移时的±hh:mm:ss），不会输出不带冒号的格式。

Java 8日期时间API在设计时，选择严格遵循ISO-8601的推荐格式而非全部可选格式。虽然ISO 8601定义了四种偏移格式，但带冒号的±hh:mm是官方推荐的首选格式，Java团队出于以下考虑限制了支持范围：

• 简化解析逻辑，减少格式匹配的歧义；
• 保持解析与输出格式的一致性，避免同一偏移量出现多种表示形式；
• 聚焦于最常用的格式场景，降低API复杂度。

如果需要解析所有ISO 8601定义的偏移格式，可以通过DateTimeFormatterBuilder自定义格式化器，添加对多种偏移格式的支持。

内容的提问来源于stack exchange，提问作者Mohamed Afzal