Home » Java » Java Reference » Java LocalDateTime Class

Java LocalDateTime Class | minusMonths() Method with Example

LocalDateTime Class minusMonths() method: Here, we are going to learn about the minusMonths() method of LocalDateTime Class with its syntax and example.
Submitted by Preeti Jain, on June 07, 2020

LocalDateTime Class minusMonths() method

• minusMonths() method is available in java.time package.
• minusMonths() method is used to subtract the given months from this date-time object and return the LocalDateTime.
• minusMonths() 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.
• minusMonths() 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 LocalDateTime minusMonths(long mon_val);

Parameter(s):

• long mon_val – represents the months to be subtracted from this LocalDateTime.

Return value:

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

Example:

// Java program to demonstrate the example 
// of minusMonths(long mon_val) method 
// of LocalDateTime

import java.time.*;

public class minusMonthsOfLocalDateTime {
    public static void main(String args[]) {
        long months = 4;
        // Instantiates two LocalDateTime
        LocalDateTime da_ti1 = LocalDateTime.parse("2005-10-05T10:10:10.00");
        LocalDateTime da_ti2 = LocalDateTime.now();

        // Display da_ti1, da_ti2 and
        // months
        System.out.println("LocalDateTime da_ti1 and da_ti2: ");
        System.out.println("da_ti1: " + da_ti1);
        System.out.println("da_ti2: " + da_ti2);
        System.out.println("months to subtract: " + months);

        System.out.println();

        // Here, this method subtracts the given
        // months from this date-time object i.e.
        // here we are subracting 4 months from 
        // this object da_ti1
        LocalDateTime minus_mon = da_ti1.minusMonths(months);

        // Display minus_mon
        System.out.print("da_ti1.minusMonths(months): ");
        System.out.println(minus_mon);

        // Here, this method subtracts the given months
        // from this date-time object i.e. here we are
        // subracting 4 months from this object
        // da_ti2
        minus_mon = da_ti2.minusMonths(months);

        // Display minus_mon
        System.out.print("da_ti2.minusMonths(months): ");
        System.out.println(minus_mon);
    }
}

Output

LocalDateTime da_ti1 and da_ti2: 
da_ti1: 2005-10-05T10:10:10
da_ti2: 2020-06-07T16:18:57.328164
months to subtract: 4

da_ti1.minusMonths(months): 2005-06-05T10:10:10
da_ti2.minusMonths(months): 2020-02-07T16:18:57.328164