尽管在 Oracle 教程示例代码中显示，Java 8 Instant 类没有 plusHours 方法

Question

Oracle Tutorial page for the Instant class显示此示例代码:

Instant oneHourLater = Instant.now().plusHours(1);

当我尝试编译这段代码时，编译器会抛出错误:

• 错误

InstantPrint.java:6: error: cannot find symbol
        Instant oneHourLater = Instant.now().plusHours(1);
                                            ^
  symbol:   method plusHours(int)
  location: class Instant

但是这个 Java 文档提到了 plusHours() 方法，但是我检查了这个 Instant 类并且它不包含 plusHours() 方法.

那么，为什么要在例子中提到这个plusHours()方法呢？

Answer 1

Oracle 教程不正确

很遗憾，Oracle 教程 在这个问题上是不正确的。那行示例代码是完全错误的。你的收获很好。

这个错误很不幸，因为本教程是学习和学习 Java 的好资源。

Instant::plus

Instant类在 Java 8 或 Java 9 中都没有定义像 plusHours 这样的方法。

您可以调用plus方法，并指定小时数。

Instant later = instant.plus( 1 , ChronoUnit.HOURS ) ;

ZonedDateTime::plusHours

Instant class 是一个基本的构建 block 类，表示UTC 中时间轴上的时刻.通常在执行诸如增加小时数之类的操作时，您可能需要考虑诸如 Daylight Saving Time 之类的异常情况。 ，所以你会关心 time zone .为此，请使用 ZonedDateTime类(class)。该类确实提供了方便的plusHours方法，这可能是教程作者困惑的根源。

指定 proper time zone name格式为continent/region，如America/Montreal , Africa/Casablanca ，或 太平洋/奥克兰。切勿使用 3-4 个字母的缩写，例如 EST 或 IST，因为它们不是真正的时区，没有标准化，甚至不是唯一的( !)。

ZoneId z = ZoneId.of( "America/Montreal" ) ;
ZonedDateTime zdt = instant.atZone( z ) ; // Same moment, but viewed through the lens of a region’s wall-clock time.
ZonedDateTime zdtLater = zdt.plusHours( 1 ) ;

Instant 与 ZonedDateTime

让我们看一个增加小时数的异常示例。分区时，我们在 2017 年 3 月 23 日凌晨 1 点的特定时刻增加了一个小时，当然预计凌晨 2 点，但我们很惊讶地看到凌晨 3 点。然而，当我们考虑 UTC 中的同一时刻而不是那个特定时区时，时间线上的同一点，添加一个小时的行为符合预期。

这个特殊的异常是由于采用 Daylight Saving Time (DST)在北美大部分地区，特别是这里，时区 America/New_York .在 Spring ，时钟“向前跳”一个小时。当时钟敲响凌晨 2 点时，他们跳到凌晨 3 点。所以那一天两点钟是不存在的。

// ZonedDateTime
LocalDate ld = LocalDate.of( 2017 , Month.MARCH , 12 ) ;
LocalTime lt = LocalTime.of( 1 , 0 ) ;
ZoneId z = ZoneId.of( "America/New_York" ) ;
ZonedDateTime zdt = ZonedDateTime.of( ld , lt , z ) ;
ZonedDateTime zdtOneHourLater = zdt.plusHours( 1 ) ;

System.out.println( "zdt: " + zdt ) ;
System.out.println( "zdtOneHourLater: " + zdtOneHourLater ) ; 
System.out.println( "Yikes! 1 AM plus an hour is 3 AM? Yes, that is an anomaly known as Daylight Saving Time (DST)." ) ;
System.out.println( "" ) ;

// Instant
Instant instant = zdt.toInstant() ;  // Adjust into UTC. Same moment, same point on the timeline, but viewed by a different wall-clock.
Instant instantOneHourLater = instant.plus( 1 , ChronoUnit.HOURS ) ;

System.out.println( "instant: " + instant ) ;
System.out.println( "instantOneHourLater: " + instantOneHourLater ) ;  
System.out.println( "Instant is always in UTC. So no anomalies, no DST. Adding an hour to 1 AM results in 2 AM every time." ) ;

查看 code run live at IdeOne.com .

zdt: 2017-03-12T01:00-05:00[America/New_York]

zdtOneHourLater: 2017-03-12T03:00-04:00[America/New_York]

Yikes! 1 AM plus an hour is 3 AM? Yes, that is an anomaly known as Daylight Saving Time (DST).

instant: 2017-03-12T06:00:00Z

instantOneHourLater: 2017-03-12T07:00:00Z

Instant is always in UTC. So no anomalies, no DST. Adding an hour to 1 AM results in 2 AM every time.