OffsetDateTime.toString()秒纳秒为0时被省略，求简便解决方法

嘿，这个问题我之前也踩过坑！完全不用自己手动实现toString或者转换逻辑，Java自带的DateTimeFormatter就能完美解决，而且是官方推荐的方案，比自己写靠谱多了。

核心思路 #

OffsetDateTime的默认toString()是遵循ISO-8601的紧凑格式，会自动省略末尾的零值部分（比如秒和纳秒都是0时就不显示）。我们只需要自定义一个固定格式的格式化器，强制显示秒和毫秒/纳秒部分就行。

具体实现代码 #

直接上例子，用DateTimeFormatter指定你想要的格式：

import java.time.OffsetDateTime;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;

public class OffsetDateTimeFormatDemo {
    public static void main(String[] args) {
        // 你创建的测试实例
        OffsetDateTime offsetDateTime = OffsetDateTime.of(2018, 3, 18, 0, 0, 0, 0, ZoneOffset.UTC);
        
        // 定义固定格式：强制显示秒和三位毫秒，时区用Z表示UTC
        DateTimeFormatter fixedFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSX");
        
        // 格式化输出
        String formattedResult = offsetDateTime.format(fixedFormatter);
        System.out.println(formattedResult); // 输出：2018-03-18T00:00:00.000Z
    }
}

格式符说明 #

• yyyy-MM-dd：标准日期格式（年-月-日）
• 'T'：日期和时间之间的分隔符，必须用单引号包裹表示固定字符
• HH:mm:ss.SSS：时间部分，强制显示时:分:秒.三位毫秒（即使毫秒是0也会补全）
• X：时区偏移标识，UTC时区会自动显示为Z，其他时区会显示如+08:00

如果需要显示纳秒（而不是毫秒），只需要把格式改成：

DateTimeFormatter nanoFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.nnnnnnnnnX");

这样输出会是2018-03-18T00:00:00.000000000Z。

进阶：全局配置（比如Spring Boot项目） #

如果是在Spring Boot这类框架里，想要所有OffsetDateTime类型的字段序列化时都用这个格式，可以配置Jackson的序列化器，不用每次手动格式化：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.fasterxml.jackson.datatype.jsr310.ser.OffsetDateTimeSerializer;
import java.time.format.DateTimeFormatter;

// 在配置类里添加这个配置
@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        JavaTimeModule timeModule = new JavaTimeModule();
        
        // 自定义格式化器
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSX");
        timeModule.addSerializer(OffsetDateTime.class, new OffsetDateTimeSerializer(formatter));
        
        mapper.registerModule(timeModule);
        return mapper;
    }
}

这样接口返回的OffsetDateTime字段都会自动按照指定格式输出，省心又统一。

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