java.time.DateTimeFormatter:需要始终呈现毫秒的ISO_INSTANT

2022-09-01 12:04:39

我正在尝试清理有关日期时间管理的各种代码的混合,以仅将Java 8 java.time命名空间。现在,我对Outstant的默认DateTimeFormatter有一个小问题。DateTimeFormatter.ISO_INSTANT 格式化程序仅在毫秒不等于零时才显示毫秒。

纪元呈现为 而不是 。1970-01-01T00:00:00Z1970-01-01T00:00:00.000Z

我做了一个单元测试来解释这个问题,以及我们需要如何将最终日期相互比较。

@Test
public void java8Date() {
    DateTimeFormatter formatter = DateTimeFormatter.ISO_INSTANT;
    String epoch, almostEpoch, afterEpoch;

    { // before epoch
        java.time.Instant instant = java.time.Instant.ofEpochMilli(-1);
        almostEpoch = formatter.format(instant);
        assertEquals("1969-12-31T23:59:59.999Z", almostEpoch );
    }

    { // epoch
        java.time.Instant instant = java.time.Instant.ofEpochMilli(0);
        epoch = formatter.format(instant);
        // This fails, I get 1970-01-01T00:00:00Z instead
        assertEquals("1970-01-01T00:00:00.000Z", epoch );
    }

    { // after epoch
        java.time.Instant instant = java.time.Instant.ofEpochMilli(1);
        afterEpoch = formatter.format(instant);
        assertEquals("1970-01-01T00:00:00.001Z", afterEpoch );
    }

    // The end game is to make sure this rule is respected (this is how we order things in dynamo):
    assertTrue(epoch.compareTo(almostEpoch) > 0);
    assertTrue(afterEpoch.compareTo(epoch) > 0); // <-- This assert would also fail if the second assert fails

    { // to confirm we're not showing nanos
        assertEquals("1970-01-01T00:00:00.000Z", formatter.format(Instant.EPOCH.plusNanos(1)));
        assertEquals("1970-01-01T00:00:00.001Z", formatter.format(Instant.EPOCH.plusNanos(1000000)));
    }
}

答案 1

好吧,我看了源代码,它非常简单:

DateTimeFormatter formatter = new DateTimeFormatterBuilder().appendInstant(3).toFormatter();

我希望它适用于所有情况,并且可以帮助其他人。不要犹豫,添加一个更好/更干净的答案。

只是为了解释它来自哪里,在JDK的代码中

ISO_INSTANT定义如下:

public static final DateTimeFormatter ISO_INSTANT;
static {
    ISO_INSTANT = new DateTimeFormatterBuilder()
            .parseCaseInsensitive()
            .appendInstant()
            .toFormatter(ResolverStyle.STRICT, null);
}

并声明为:DateTimeFormatterBuilder::appendInstant

public DateTimeFormatterBuilder appendInstant() {
    appendInternal(new InstantPrinterParser(-2));
    return this;
}

构造函数签名是:InstantPrinterParser

InstantPrinterParser(int fractionalDigits)

答案 2

弗洛伦特接受的答案是正确和好的。

我只想补充一些澄清。

上面提到的格式化程序 DateTimeFormatter.ISO_INSTANT 是仅 Instant 类的默认格式化程序。默认情况下,其他类(如 ZonedDateTime)可能使用其他格式化程序。OffsetDateTime

java.time 类提供高达纳秒的分辨率,比毫秒更精细粒度。这意味着小数点最多有9位数字,而不仅仅是3位数字。

的行为因小数位数而异。正如文档所说(强调我的):DateTimeFormatter.ISO_INSTANT

格式化时,始终输出分钟中的秒数。纳秒输出零位、三位、六位或九位数字。

因此,根据对象中包含的数据值,您可能会看到以下任何输出:Instant

2011-12-19T10:15:30Z

2011-12-09T10:15:30.100Z

2011-12-09T10:15:30.120Z

2011-12-03T10:15:30.123Z

2011-12-09T10:15:30.123400Z

2011-12-09T10:15:30.123456Z

2011-12-03T10:15:30.123456780Z

2011-12-03T10:15:30.123456789Z

该类旨在成为java.time的基本构建块。经常使用它进行数据传递、数据存储和数据交换。生成数据的字符串表示形式以呈现给用户时,请使用 OffsetDateTimeZonedDateTimeInstant