Java LocalDate plusYears()用法及代码示例

Java中的LocalDate类的plusYears()方法用于在此LocalDate中添加指定的年数，并返回LocalDate的副本。

此方法通过以下步骤添加年份字段：

将年份添加到年份字段。
检查加年后的日期是否有效。
如果日期无效，则将方法day-of-month调整为最后一个有效日期。

例如，2016-02-29(le年)加上一年给出的日期为2017-02-29，但这是无效的结果，因此将返回该月的最后一个有效日2017-02-28。此实例是不可变的并且不受此方法调用的影响。

用法:

public LocalDate plusYears(long yearsToAdd)

参数：此方法接受单个参数yearsToAdd，该参数表示要添加的年份，可以为负数。

返回值：此方法基于添加了年份的日期返回LocalDate，而不是null。

异常：如果结果超出支持的日期范围，则此方法将引发DateTimeException。

以下示例程序旨在说明plusYears()方法：

示例1:

// Java program to demonstrate 
// LocalDate.plusYears() method 
  
import java.time.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
  
        // create a LocalDate object 
        LocalDate date 
            = LocalDate.parse("2018-11-13"); 
  
        // print instance 
        System.out.println("LocalDate before"
                           + " adding years: " + date); 
  
        // add 3 years 
        LocalDate returnvalue 
            = date.plusYears(3); 
  
        // print result 
        System.out.println("LocalDate after "
                           + " adding years: " + returnvalue); 
    } 
}

输出：

LocalDate before adding years: 2018-11-13
LocalDate after  adding years: 2021-11-13

示例2:

// Java program to demonstrate 
// LocalDate.plusYears() method 
  
import java.time.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
  
        // create a LocalDate object 
        LocalDate date 
            = LocalDate.parse("2016-02-29"); 
  
        // print instance 
        System.out.println("LocalDate before"
                           + " adding years: " + date); 
  
        // add 2 years 
        LocalDate returnvalue 
            = date.plusYears(2); 
  
        // print result 
        System.out.println("LocalDate after "
                           + " adding years: " + returnvalue); 
    } 
}

输出：

LocalDate before adding years: 2016-02-29
LocalDate after  adding years: 2018-02-28

参考文献：
https://docs.oracle.com/javase/10/docs/api/java/time/LocalDate.html#plusYears(long)

相关用法

注：本文由纯净天空筛选整理自AmanSingh2210大神的英文原创作品 LocalDate plusYears() method in Java with Examples。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。