Sunday, November 23, 2025
HomeLanguagesJavaYearMonth withYear() method in Java with Examples

YearMonth withYear() method in Java with Examples

withYear(int year) method of the YearMonth class used to alter the year of YearMonth object using year passed as a parameter and after that method returns the copy of altered YearMonth. This instance is immutable and unaffected by this method call.

Syntax:

public YearMonth withYear(int year)

Parameters: This method accepts month as parameter which is the year to set in the returned year-month, from MIN_YEAR to MAX_YEAR.

Return value: This method returns a YearMonth based on this year-month with the requested year.

Exception: This method throws DateTimeException if the year value is invalid.

Below programs illustrate the withYear() method:
Program 1:




// Java program to demonstrate
// YearMonth.withYear() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a YearMonth object
        YearMonth yr
            = YearMonth.of(2019, 12);
  
        // print instance
        System.out.println("YearMonth before"
                           + " applying method: "
                           + yr);
  
        // apply withYear method of YearMonth class
        YearMonth updatedlocal = yr.withYear(2023);
  
        // print instance
        System.out.println("YearMonth after"
                           + " applying method: "
                           + updatedlocal);
    }
}


Output:

YearMonth before applying method: 2019-12
YearMonth after applying method: 2023-12

Program 2:




// Java program to demonstrate
// YearMonth.withYear() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a YearMonth object
        YearMonth yr
            = YearMonth.of(2022, 7);
  
        // print instance
        System.out.println("YearMonth before"
                           + " applying method: "
                           + yr);
  
        // apply withYear method of YearMonth class
        YearMonth updatedlocal = yr.withYear(1992);
  
        // print instance
        System.out.println("YearMonth after"
                           + " applying method: "
                           + updatedlocal);
    }
}


Output:

YearMonth before applying method: 2022-07
YearMonth after applying method: 1992-07

References: https://docs.oracle.com/javase/10/docs/api/java/time/YearMonth.html#withYear(int)

RELATED ARTICLES

Most Popular

Dominic
32407 POSTS0 COMMENTS
Milvus
97 POSTS0 COMMENTS
Nango Kala
6785 POSTS0 COMMENTS
Nicole Veronica
11932 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12000 POSTS0 COMMENTS
Shaida Kate Naidoo
6907 POSTS0 COMMENTS
Ted Musemwa
7168 POSTS0 COMMENTS
Thapelo Manthata
6864 POSTS0 COMMENTS
Umr Jansen
6852 POSTS0 COMMENTS