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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。