Open In App

LocalDateTime withMonth() method in Java with Examples

Improve
Improve
Like Article
Like
Save
Share
Report

The withMonth() method of LocalDateTime class in Java is used to get a copy of this LocalDateTime with the months changed to the months passed as the parameter to this method. The remaining values of this LocalDateTime remains the same.

Syntax:

public LocalDateTime withMonth(int months)

Parameter: This method accepts a single mandatory parameter months which specifies the months to be set in the resultant LocalDateTime instance. The value of this months can range from 1 to 12.

Returns: The function returns a LocalDateTime instance with the months changed to the months passed as the parameter to this method. The remaining values of this LocalDateTime remains the same.

Exceptions: The function throws a DateTimeException if the months value is invalid.

Below programs illustrate the LocalDateTime.withMonth() method:

Program 1:




// Program to illustrate the withMonth() method
  
import java.util.*;
import java.time.*;
  
public class GfG {
    public static void main(String[] args)
    {
        // Get the LocalDateTime instance
        LocalDateTime dt = LocalDateTime.now();
  
        // Get the String representation of this LocalDateTime
        System.out.println("Original LocalDateTime: "
                           + dt.toString());
  
        // Get a new LocalDateTime with months 5
        System.out.println("New LocalDateTime: "
                           + dt.withMonth(5));
    }
}


Output:

Original LocalDateTime: 2018-11-30T12:51:39.472
New LocalDateTime: 2018-05-30T12:51:39.472

Program 2:




// Program to illustrate the withMonth() method
  
import java.util.*;
import java.time.*;
  
public class GfG {
    public static void main(String[] args)
    {
        // Get the LocalDateTime instance
        LocalDateTime dt
            = LocalDateTime
                  .parse("2015-04-06T10:15:30");
  
        // Get the String representation of this LocalDateTime
        System.out.println("Original LocalDateTime: "
                           + dt.toString());
  
        // Get a new LocalDateTime with months 12
        System.out.println("New LocalDateTime: "
                           + dt.withMonth(12));
    }
}


Output:

Original LocalDateTime: 2015-04-06T10:15:30
New LocalDateTime: 2015-12-06T10:15:30

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



Last Updated : 30 Nov, 2018
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads