Home » Java » Java Reference » Java LocalDate Class

Java LocalDate Class | minusYears() Method with Example

LocalDate Class minusYears() method: Here, we are going to learn about the minusYears() method of LocalDate Class with its syntax and example.
Submitted by Preeti Jain, on May 31, 2020

LocalDate Class minusYears() method

• minusYears() method is available in java.time package.
• minusYears() method is used to subtract the given years from this LocalDate and return the LocalDate.
• minusYears() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• minusYears() method may throw an exception at the time of performing subtraction.
  DateTimeException: This exception may throw when the calculated result value exceeds the limit.

Syntax:

    public LocalDate minusYears(long yrs_val);

Parameter(s):

• long yrs_val – represents the years to be subtracted from this LocalDate.

Return value:

The return type of this method is LocalDate, it returns the LocalDate that holds the value subtracted the given years from this LocalDate.

Example:

// Java program to demonstrate the example 
// of minusYears(long yrs_val) method of LocalDate

import java.time.*;

public class MinusYearsOfLocalDate {
    public static void main(String args[]) {
        long years = 3;
        // Instantiates two LocalDate
        LocalDate l_da1 = LocalDate.parse("2007-04-04");
        LocalDate l_da2 = LocalDate.of(2008, Month.FEBRUARY, 06);

        // Display l_da1,l_da2 and years
        System.out.println("LocalDate l_da1,l_da2 : ");
        System.out.println("l_da1: " + l_da1);
        System.out.println("l_da2: " + l_da2);
        System.out.println("years to subtract: " + years);

        System.out.println();

        // Here, this method subtracts the
        // given years from this date l_da1
        // i.e. here we are subtracting 3
        // years from the date l_da1
        LocalDate minus_yrs = l_da1.minusYears(years);

        // Display minus_yrs
        System.out.println("l_da1.minusYears(years): " + minus_yrs);

        // Here, this method subtracts the
        // given years from this date l_da2
        // i.e. here we are subtracting 3
        // years from the date l_da2
        minus_yrs = l_da2.minusYears(years);

        // Display minus_yrs
        System.out.println("l_da2.minusYears(years): " + minus_yrs);
    }
}

Output

LocalDate l_da1,l_da2 : 
l_da1: 2007-04-04
l_da2: 2008-02-06
years to subtract: 3

l_da1.minusYears(years): 2004-04-04
l_da2.minusYears(years): 2005-02-06