LocalDateTime plusMonths() method in Java with Examples

The plusMonths() method of LocalDateTime class is used to return a copy of this date-time with the specified months added.

Syntax:

public LocalDateTime plusMonths(long months)

Parameter: It accepts a single parameter months which specifies the months to add which may be negative.

Return Value: This method returns a LocalDateTime based on this date-time with the months added.

Exceptions: The programs throws a DateTimeException which is thrown if the result exceeds the supported months range.

Below programs illustrate the YearMonth.plusMonths() method in Java:

Program 1:

// Program to illustrate the plusMonths() method

import java.util.*;
import java.time.*;

public class GfG {
    public static void main(String[] args)
    {
        LocalDateTime dt1
            = LocalDateTime
                  .parse("2018-01-11T10:15:30");

        System.out.println("LocalDateTime with 15 months added: "
                           + dt1.plusMonths(15));
    }
}

Output:

LocalDateTime with 15 months added: 2019-04-11T10:15:30

Program 2:

// Program to illustrate the plusMonths() method

import java.util.*;
import java.time.*;

public class GfG {
    public static void main(String[] args)
    {
        LocalDateTime dt1
            = LocalDateTime
                  .parse("2018-01-11T08:15:30");

        System.out.println("LocalDateTime with -2 months added: "
                           + dt1.plusMonths(-2));
    }
}

Output:

LocalDateTime with -2 months added: 2017-11-11T08:15:30

Reference: https://docs.oracle.com/javase/10/docs/api/java/time/LocalDateTime.html#plusMonths(long)