Year plus(TemporalAmount) method in Java with Examples

Last Updated : 25 Feb, 2019

The plus(TemporalAmount) method of Year class is used to return a copy of this year after adding the specified amount of TemporalAmount to this Year object. An exception is thrown, If the specified unit cannot be added to Year. The TemporalAmount passed is created from the Period object. This instance is immutable and unaffected by this method call.

Syntax:

public Year plus(TemporalAmount amountToadd)

Parameters: This method accepts only one parameter TemporalAmount which represents the amount to add to Year object.

Return Value: This method returns a Year based on this year with the specified amount added.

Exception: This method throws following Exceptions:

DateTimeException – This exception is thrown if the addition cannot be made.
ArithmeticException – This exception is thrown if numeric overflow occurs.

Below programs illustrate the plus(TemporalAmount amountToadd) method:

Program 1:

// Java program to demonstrate 
// Year.plus(TemporalAmount amountToadd) method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
        // create a Year object 
        Year year = Year.of(2019); 
  
        // print instance 
        System.out.println("Year :"
                           + year); 
  
        // create temporalAmount object from period class 
        // passing temporalAmount to 
        // plus() method 
        Year value 
            = year.plus( 
                Period.ofYears(12)); 
  
        // print result 
        System.out.println("Value after addition: "
                           + value); 
    } 
} 

Output:

Year :2019
Value after addition: 2031

Program 2:

// Java program to demonstrate 
// Year.plus(TemporalAmount amountToadd) method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
        // create a Year object 
        Year year = Year.of(2019); 
  
        // print instance 
        System.out.println("Year :"
                           + year); 
  
        // create temporalAmount object from period class 
        // passing temporalAmount to 
        // plus() method 
        Year value 
            = year.plus( 
                Period.ofYears(120)); 
  
        // print result 
        System.out.println("Value after addition: "
                           + value); 
    } 
} 