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

时间:2016-06-26 19:02:08

标签: java java-8 datetime-format

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

时期呈现为1970-01-01T00:00:00Z而不是1970-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)));
    }
}

2 个答案:

答案 0 :(得分:13)

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

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

我希望它适用于所有场景,它可以帮助其他人。不要犹豫,添加更好/更清洁的答案。

只是为了解释它的来源,in the JDK's code

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)

答案 1 :(得分:2)

accepted Answer by Florent是正确和良好的。

我只想补充一些说明。

上述格式化程序DateTimeFormatter.ISO_INSTANT仅适用于Instant类。其他类(例如OffsetDateTimeZonedDateTime)默认情况下可能会使用其他格式化程序。

java.time类提供的分辨率最高为nanosecond,比milliseconds的粒度更精细。这意味着小数部分最多9位数而不仅仅是3位数。

DateTimeFormatter.ISO_INSTANT的行为因小数部分的位数而异。正如医生所说(强调我的):

  

格式化时,始终输出秒的秒数。毫秒秒根据需要输出零,三,六或九位

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

  

2011-12-03T10:15:30Z

     

2011-12-03T10:15:30.100Z

     

2011-12-03T10:15:30.120Z

     

2011-12-03T10:15:30.123Z

     

2011-12-03T10:15:30.123400Z

     

2011-12-03T10:15:30.123456Z

     

2011-12-03T10:15:30.123456780Z

     

2011-12-03T10:15:30.123456789Z

Instant类是java.time的基本构建块。经常用于数据传递,数据存储和数据交换。生成用于呈现给用户的数据的字符串表示时,请使用OffsetDateTimeZonedDateTime