Java ZonedDateTime plusYears()方法及示例

ZonedDateTime 类的 plusYears() 方法用于增加该ZonedDateTime的年数，并在增加后返回ZonedDateTime的副本。该方法对本地时间线进行操作，在本地日期时间上增加年数，在增加年数后本地日期时间被转换回ZonedDateTime，使用区域ID来获得偏移。当转换回ZonedDateTime时，如果本地日期时间处于重叠状态，那么可能的话将保留偏移量，否则，将使用较早的偏移量。这个实例是不可改变的，不受这个方法调用的影响。

语法

public ZonedDateTime plusYears(long years)

参数： 该方法接受一个单一的参数year，代表要添加的年份，它可以是负数。

返回值： 该方法返回一个基于该日期时间并加上年份的ZonedDateTime。

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

以下程序说明了plusYears()方法：

程序1 :

// Java program to demonstrate
// ZonedDateTime.plusYears() 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 years: "
                           + zoneddatetime);
  
        // add 5 years
        ZonedDateTime returnvalue
            = zoneddatetime.plusYears(5);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + "adding 5 years: "
                           + returnvalue);
    }
}

输出。

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

程序2 :

// Java program to demonstrate
// ZonedDateTime.plusYears() 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 years: "
                           + zoneddatetime);
  
        // add 2 years
        ZonedDateTime returnvalue
            = zoneddatetime.plusYears(2);
  
        // print result
        System.out.println("ZonedDateTime after "
                           + "adding 2 years: "
                           + returnvalue);
    }
}

输出。

ZonedDateTime before adding years: 2018-10-25T23:12:31.123+02:00[Europe/Paris]
ZonedDateTime after adding 2 years: 2020-10-25T23:12:31.123+01:00[Europe/Paris]

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