Java ZonedDateTime plusHours()方法及示例

ZonedDateTime 类的 plusHours() 方法用于增加该ZonedDateTime的小时数，并在增加后返回ZonedDateTime的副本。这是在即时时间线上操作的，因此增加一个小时将总是一个小时后的持续时间。增加一个小时可能会导致当地的日期时间发生一个不同于一小时的变化。

例如，考虑一个时区，如 “欧洲/巴黎”，秋季DST的切换意味着当地时间02:00到02:59发生两次变化，从夏季的偏移量+02:00到冬季的+01:00。

在01:30+02:00的基础上增加一个小时，就会出现02:30+02:00（都是夏季时间）。
在02:30+02:00增加一个小时，将导致02:30+01:00（从夏时到冬时）。
在02:30+01:00的基础上增加一个小时，将导致03:30+01:00（都是冬令时）。
在01:30+02:00的基础上增加3个小时，将导致03:30+01:00（从夏令时转为冬令时）。

这个实例是不可改变的，不受这个方法调用的影响。

语法

public ZonedDateTime plusHours(long hours)

参数： 该方法接受一个参数hours，代表要添加的小时数，它可以是负数。

返回值： 该方法返回一个基于该日期时间并添加了小时的ZonedDateTime，而不是空的。

异常： 如果结果超过了支持的日期范围，该方法会抛出DateTimeException。

下面的程序说明了plusHours()方法：

程序1 :

// Java program to demonstrate
// ZonedDateTime.plusHours() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");
  
        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding hours: "
                           + zoneddatetime);
  
        // add 3 hours
        ZonedDateTime returnvalue
            = zoneddatetime.plusHours(3);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding hours: "
                           + returnvalue);
    }
}

输出。

ZonedDateTime before adding hours: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta]
ZonedDateTime after adding hours: 2018-12-06T22:21:12.123+05:30[Asia/Calcutta]

程序2 :

// Java program to demonstrate
// ZonedDateTime.plusHours() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-10-25T23:12:31.123+02:00[Europe/Paris]");
  
        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding hours: "
                           + zoneddatetime);
  
        // add 20 hours
        ZonedDateTime returnvalue
            = zoneddatetime.plusHours(20);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + " adding hours: "
                           + returnvalue);
    }
}

输出。

ZonedDateTime before adding hours: 2018-10-25T23:12:31.123+02:00[Europe/Paris]
ZonedDateTime after adding hours: 2018-10-26T19:12:31.123+02:00[Europe/Paris]

参考资料: https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#plusHours(long)