Year minus(TemporalAmount) method in Java with Examples

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

Syntax:

public Year minus(TemporalAmount amountToSubtract)

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

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

Exception: This method throws following Exceptions:

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

Below programs illustrate the minus(TemporalAmount amountToSubtract) method:

Program 1:

// Java program to demonstrate
// Year.minus(TemporalAmount amountToSubtract) 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
        // minus() method
        Year value
            = year.minus(
                Period.ofYears(40));

        // print result
        System.out.println("Value after Subtraction: "
                           + value);
    }
}

Output:

Year :2019
Value after Subtraction: 1979

Program 2:

// Java program to demonstrate
// Year.minus(TemporalAmount amountToSubtract) 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
        // minus() method
        Year value
            = year.minus(
                Period.ofYears(20));

        // print result
        System.out.println("Value after Subtraction: "
                           + value);
    }
}

Output:

Year :2019
Value after Subtraction: 1999

References:
https://docs.oracle.com/javase/10/docs/api/java/time/Year.html#minus(java.time.temporal.TemporalAmount)