OffsetDateTime withYear() method in Java with examples

The withYear() method of OffsetDateTime class in Java returns a copy of this OffsetDateTime with the year altered as specified in the parameter.

Syntax:

public OffsetDateTime withYear(int year)

Parameter: This method accepts a single parameter year which specifies the year to be set in the result which can range from MIN_YEAR to MAX_YEAR.

Return Value: It returns a OffsetDateTime based on this date with the requested year and not null.

Exceptions: The program throws a DateTimeException when the year value is invalid.

Below programs illustrate the withYear() method:

Program 1:

// Java program to demonstrate the withYear() method

import java.time.OffsetDateTime;

public class GFG {
    public static void main(String[] args)
    {

        // Parses the date1
        OffsetDateTime date1
            = OffsetDateTime
                  .parse(
                      "2018-12-12T13:30:30+05:00");

        // Prints dates
        System.out.println("Date1: " + date1);

        // Changes the year
        System.out.println("Date1 after altering year: "
                           + date1.withYear(2019));
    }
}

Output:

Date1: 2018-12-12T13:30:30+05:00
Date1 after altering year : 2019-12-12T13:30:30+05:00

Program 2:

// Java program to demonstrate the withYear() method

import java.time.OffsetDateTime;

public class GFG {
    public static void main(String[] args)
    {

        // Parses the date1
        OffsetDateTime date1
            = OffsetDateTime
                  .parse(
                      "2018-12-12T13:30:30+05:00");

        // Prints dates
        System.out.println("Date1: " + date1);

        // Changes the year
        System.out.println("Date1 after altering year: "
                           + date1.withYear(2010));
    }
}

Output:

Date1: 2018-12-12T13:30:30+05:00
Date1 after altering year: 2010-12-12T13:30:30+05:00

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