如何将带+0000时区偏移的字符串日期时间转换为Java Instant

现有代码问题 #

你提供的代码无法生效核心有两个问题：

• 最后一级try块没有搭配catch逻辑，不管是否匹配到yyyy-MM-dd'T'HH:mm:ss.SSSZ格式，finally块都会直接抛出非法参数异常，导致转换逻辑被中断
• 带时区偏移的字符串用LocalDateTime解析会直接丢弃偏移信息，强制转UTC会出现时间差错误，多重嵌套try-catch的写法也不利于后续维护扩展

正确实现代码 #

import org.apache.commons.lang3.StringUtils;
import java.time.Instant;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.ArrayList;
import java.util.List;

public class DateUtils {
    // 预定义所有需要支持的日期格式，后续新增格式直接追加即可
    private static final List<DateTimeFormatter> FORMATTERS = new ArrayList<>();
    static {
        // 匹配yyyy-MM-dd HH:mm:ss格式
        FORMATTERS.add(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(java.time.ZoneOffset.UTC));
        // 匹配yyyy-MM-dd HH:mm:ss.SSS格式
        FORMATTERS.add(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS").withZone(java.time.ZoneOffset.UTC));
        // 匹配yyyy-MM-dd HH:mm:ss.SSSSSS格式
        FORMATTERS.add(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSS").withZone(java.time.ZoneOffset.UTC));
        // 匹配示例格式2018-08-10T18:25:00.000+0000
        FORMATTERS.add(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSZ"));
    }

    public static Instant toInstant(final String timeStr) {
        if (StringUtils.isBlank(timeStr)) {
            throw new IllegalArgumentException("Invalid date time value passed [" + timeStr + "]");
        }
        // 优先尝试原生Instant解析，支持标准ISO_INSTANT格式
        try {
            return Instant.parse(timeStr);
        } catch (DateTimeParseException ignored) {
        }
        // 遍历所有预定义格式匹配
        for (DateTimeFormatter formatter : FORMATTERS) {
            try {
                return Instant.from(formatter.parse(timeStr));
            } catch (DateTimeParseException ignored) {
            }
        }
        // 所有格式都不匹配抛出异常
        throw new IllegalArgumentException("Incorrect date time value passed [" + timeStr + "]");
    }
}

实现说明 #

• 优先调用Instant.parse()原生方法，可直接兼容大部分标准ISO格式的日期字符串转换，性能最优
• 所有自定义格式统一维护在静态列表中，后续新增格式不需要修改转换逻辑，只要追加格式化器即可，可维护性更高
• 每个格式化器提前绑定对应时区，带偏移的格式不会丢失时区信息，转换结果准确
• 去掉了冗余的嵌套try-catch结构，代码可读性更高

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