LocalDateTime withYear() method in Java with Examples

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

Syntax:

public LocalDateTime withYear(int year)

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



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

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

Below programs illustrate the LocalDateTime.withYear() method:

Program 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Program to illustrate the withYear() 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 year 1998
        System.out.println("New LocalDateTime: "
                           + dt.withYear(1998));
    }
}

chevron_right


Output:

Original LocalDateTime: 2018-11-30T10:35:17.833
New LocalDateTime: 1998-11-30T10:35:17.833

Program 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Program to illustrate the withYear() 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 year 20129
        System.out.println("New LocalDateTime: "
                           + dt.withYear(20129));
    }
}

chevron_right


Output:

Original LocalDateTime: 2015-04-06T10:15:30
New LocalDateTime: +20129-04-06T10:15:30

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



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.