如何构造至少保留毫秒精度的LocalDateTime格式化器

要实现「ISO格式输出LocalDateTime，至少保留毫秒精度，更高精度完整输出」的需求，我们可以通过DateTimeFormatterBuilder定制格式化规则，避开现成格式的局限性。

核心实现代码 #

直接上可用的格式化器构造代码：

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.temporal.ChronoField;

public class CustomDateTimeFormatExample {
    public static void main(String[] args) {
        DateTimeFormatter customIsoFormatter = new DateTimeFormatterBuilder()
                // 固定ISO日期时间的基础部分
                .appendPattern("yyyy-MM-dd'T'HH:mm:ss")
                // 处理小数秒：至少3位（毫秒），最多9位（纳秒），始终显示小数点
                .appendFraction(ChronoField.NANO_OF_SECOND, 3, 9, true)
                .toFormatter();

        // 测试不同精度的LocalDateTime
        LocalDateTime dtWithNoMillis = LocalDateTime.parse("2018-01-01T00:00:00");
        System.out.println(dtWithNoMillis.format(customIsoFormatter)); 
        // 输出：2018-01-01T00:00:00.000

        LocalDateTime dtWithMicros = LocalDateTime.parse("2018-01-01T00:00:00.123456");
        System.out.println(dtWithMicros.format(customIsoFormatter)); 
        // 输出：2018-01-01T00:00:00.123456

        LocalDateTime dtWithNanos = LocalDateTime.parse("2018-01-01T00:00:00.123456789");
        System.out.println(dtWithNanos.format(customIsoFormatter)); 
        // 输出：2018-01-01T00:00:00.123456789
    }
}

为什么这个方案可行？ #

• appendPattern("yyyy-MM-dd'T'HH:mm:ss") 确保了基础的ISO日期时间格式正确，避免了默认格式的不确定性。
• appendFraction方法的参数是关键：
  • ChronoField.NANO_OF_SECOND：指定我们要处理的是纳秒级的小数秒字段
  • 3：最小位数——即使原时间没有小数部分，也会补零到3位（保证毫秒精度）
  • 9：最大位数——如果原时间有微秒（6位）或纳秒（9位）精度，会完整输出所有有效位，不会截断
  • true：强制显示小数点，哪怕只有补零的毫秒部分（比如无小数的时间也会显示.000）

为什么其他方案不适用？ #

• ISO_INSTANT：这个格式化器是给ZonedDateTime/Instant用的，输出会带Z时区后缀，完全不符合LocalDateTime的无时区需求。
• 直接用yyyy-MM-dd'T'HH:mm:ss.SSS模式：这个模式会截断超过3位的小数秒，比如微秒的后3位会被丢弃，无法完整保留更高精度的时间信息。

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