YearMonth minusYears() in Java with Examples

The minusYears() method of YearMonth class in Java is used to return a copy of this YearMonth with the specified number of years subtracted.

Syntax:

public YearMonth minusYears(long yearsToSubtract)

Parameter: This method accepts yearsToSubtract as parameters which represents years to be subtracted. It may be negative.

Return Value: It returns a YearMonth based on this year-month with the years subtracted.

Exceptions: This method throws DateTimeException if the result exceeds the supported range.

Below programs illustrate the minusYears() method of YearMonth in Java:

Program 1:

// Java program to demonstrate
// YearMonth.minusYears() method

import java.time.*;
import java.time.temporal.*;

public class GFG {
    public static void main(String[] args)
    {
        // create YearMonth object
        YearMonth yearmonth
            = YearMonth.parse("2020-05");
        // It is May 2020

        // apply minusYears() method
        // of YearMonth class
        YearMonth result
            = yearmonth.minusYears(5);
        // Subtracting 5 years will turn it
        // into May 2015

        // print year and month both
        System.out.println(
            "Modified YearMonth: "
            + result);
    }
}

Output:

Modified YearMonth: 2015-05

Program 2:

// Java program to demonstrate
// YearMonth.minusYears() method

import java.time.*;
import java.time.temporal.*;

public class GFG {
    public static void main(String[] args)
    {
        // create YearMonth object
        YearMonth yearmonth
            = YearMonth.of(2019, 10);

        // apply minusYears() method
        // of YearMonth class
        YearMonth result
            = yearmonth.minusYears(10);
        // Subtracting 10 years will
        // turn it into October 2009

        // print only year
        System.out.println(
            "Modified Year: "
            + result.get(ChronoField.YEAR));
    }
}

Output:

Modified Year: 2009

References: https://docs.oracle.com/javase/10/docs/api/java/time/YearMonth.html#minusYears(long)