ChronoZonedDateTime withEarlierOffsetAtOverlap() method in Java with Examples

The withEarlierOffsetAtOverlap() method of a ChronoZonedDateTime interface is used to return a copy of this ChronoZonedDateTime object after changing the zone offset to the earlier of the two valid offsets at a local time-line overlap. The overlap happens when Daylight saving time finishes and one hour is returned to the timeline. Due to this there are two valid offsets for the local date-time and calling withEarlierOffsetAtOverlap method will return a ChronoZonedDateTime with the earlier of the two zones. If this method is called when it is not an overlap, this is returned. This instance is immutable and unaffected by this method call.

Syntax:

ChronoZonedDateTime withEarlierOffsetAtOverlap()

Parameters: This method accepts no parameters.

Return value: This method returns a ChronoZonedDateTime based on this date-time with the earlier offset.

Below programs illustrate the withEarlierOffsetAtOverlap() method:

Program 1:

// Java program to demonstrate
// withEarlierOffsetAtOverlap() method

import java.time.*;
import java.time.chrono.*;

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

        // create a ChronoZonedDateTime object
        ChronoZonedDateTime zonedDT
            = ZonedDateTime
                  .ofLocal(
                      LocalDateTime.of(2018, 11, 4, 1, 25, 43),
                      ZoneId.of("US/Central"),
                      ZoneOffset.ofHours(-6));

        // print ChronoZonedDateTime
        System.out.println("Before"
                           + " withEarlierOffsetAtOverlap():\n "
                           + zonedDT);

        // apply withEarlierOffsetAtOverlap()
        ChronoZonedDateTime zonedDT2
            = zonedDT.withEarlierOffsetAtOverlap();

        // print ChronoZonedDateTime after
        // withEarlierOffsetAtOverlap()
        System.out.println("\nAfter"
                           + " withEarlierOffsetAtOverlap():\n "
                           + zonedDT2);
    }
}

Output:

Before withEarlierOffsetAtOverlap():
 2018-11-04T01:25:43-06:00[US/Central]

After withEarlierOffsetAtOverlap():
 2018-11-04T01:25:43-05:00[US/Central]

Program 2:

// Java program to demonstrate
// withEarlierOffsetAtOverlap() method

import java.time.*;
import java.time.chrono.*;

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

        // create a ChronoZonedDateTime object
        ChronoZonedDateTime zonedDT
            = ZonedDateTime
                  .ofLocal(
                      LocalDateTime.of(2021, 11, 07, 1, 05, 53),
                      ZoneId.of("US/Central"),
                      ZoneOffset.ofHours(-6));

        // print ChronoZonedDateTime
        System.out.println("Before"
                           + " withEarlierOffsetAtOverlap():\n "
                           + zonedDT);

        // apply withEarlierOffsetAtOverlap()
        ChronoZonedDateTime zonedDT2
            = zonedDT.withEarlierOffsetAtOverlap();

        // print ChronoZonedDateTime after
        // withEarlierOffsetAtOverlap()
        System.out.println("\nAfter"
                           + " withEarlierOffsetAtOverlap():\n "
                           + zonedDT2);
    }
}

Output:

Before withEarlierOffsetAtOverlap():
 2021-11-07T01:05:53-06:00[US/Central]

After withEarlierOffsetAtOverlap():
 2021-11-07T01:05:53-05:00[US/Central]

Reference: https://docs.oracle.com/javase/9/docs/api/java/time/chrono/ChronoZonedDateTime.html#withEarlierOffsetAtOverlap–