java.time.OffsetDateTime.withMonth() Method Example

Description

The java.time.OffsetDateTime.withMonth(int month) method returns a copy of this OffsetDateTime with the month-of-year altered.

Declaration

Following is the declaration for java.time.OffsetDateTime.withMonth(int month) method.

public OffsetDateTime withMonth(int month)

Parameters

month − the month-of-year to set in the result, from 1 (January) to 12 (December).

Return Value

a OffsetDateTime based on this date with the requested month, not null.

Exceptions

DateTimeException − if the month-of-year value is invalid.

Example

The following example shows the usage of java.time.OffsetDateTime.withMonth(int month) method.

package com.tutorialspoint;

import java.time.OffsetDateTime;

public class OffsetDateTimeDemo {
   public static void main(String[] args) {
      
      OffsetDateTime date = OffsetDateTime.parse("2017-01-03T10:15:30+01:00");
      OffsetDateTime result = date.withMonth(3);
      System.out.println(result);  
   }
}

Let us compile and run the above program, this will produce the following result −

2017-03-03T10:15:30+01:00