OffsetDateTime withMonth() method in Java with examples
Last Updated :
17 Dec, 2018
The withMonth() method of OffsetDateTime class in Java returns a copy of this OffsetDateTime with the month-of-year altered as specified in the parameter.
Syntax:
public OffsetDateTime withMonth(int month)
Parameter: This method accepts a single parameter month which specifies the month-of-year to be set in the result which can range from 1 to 12.
Return Value: It returns a OffsetDateTime based on this date with the requested month-of-year and not null.
Exceptions: The program throws a DateTimeException when the month-of-year value is invalid.
Below programs illustrate the withMonth() method:
Program 1:
import java.time.OffsetDateTime;
import java.time.ZonedDateTime;
public class GFG {
public static void main(String[] args)
{
OffsetDateTime date1
= OffsetDateTime
.parse(
"2018-12-12T13:30:30+05:00" );
System.out.println( "Date1: " + date1);
System.out.println( "Date1 after altering month-of-year: "
+ date1.withMonth( 10 ));
}
}
|
Output:
Date1: 2018-12-12T13:30:30+05:00
Date1 after altering month-of-year: 2018-10-12T13:30:30+05:00
Program 2:
import java.time.OffsetDateTime;
public class GFG {
public static void main(String[] args)
{
try {
OffsetDateTime date1
= OffsetDateTime
.parse(
"2018-12-12T13:30:30+05:00" );
System.out.println( "Date1: " + date1);
System.out.println( "Date1 after altering month-of-year: "
+ date1.withMonth( 27 ));
}
catch (Exception e) {
System.out.println( "Exception: " + e);
}
}
}
|
Output:
Date1: 2018-12-12T13:30:30+05:00
Exception: java.time.DateTimeException: Invalid value for MonthOfYear (valid values 1 - 12): 27
Reference: https://docs.oracle.com/javase/10/docs/api/java/time/OffsetDateTime.html#withMonth(int)
Like Article
Suggest improvement
Share your thoughts in the comments
Please Login to comment...