java.time.YearMonth.withYear() Method Example

Description

The java.time.YearMonth.withYear(int year) method returns a copy of this YearMonth with the year altered.

Declaration

Following is the declaration for java.time.YearMonth.withYear(int year) method.

public YearMonth withYear(int year)

Parameters

year − the year to set in the returned year-month, from MIN_YEAR to MAX_YEAR.

Return Value

a YearMonth based on this with the adjustment made, not null.

Exceptions

DateTimeException − if the year value is invalid.

Example

The following example shows the usage of java.time.YearMonth.withYear(int year) method.

package com.tutorialspoint;

import java.time.YearMonth;

public class YearMonthDemo {
   public static void main(String[] args) {
      
      YearMonth date = YearMonth.parse("2017-12");
      YearMonth result = date.withYear(2008);
      System.out.println(result);  
   }
}

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

2008-12