Home » Java » Java Reference » Java LocalDateTime Class

Java LocalDateTime Class | atOffset() Method with Example

LocalDateTime Class atOffset() method: Here, we are going to learn about the atOffset() method of LocalDateTime Class with its syntax and example.
Submitted by Preeti Jain, on June 04, 2020

LocalDateTime Class atOffset() method

• atOffset() method is available in java.time package.
• atOffset() method is used to create an OffsetDateTime to merge this LocalDateTime with the given offset.
• atOffset() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• atOffset() method does not throw an exception at the time of representing LocalDateTime.

Syntax:

    public OffsetDateTime atOffset(ZoneOffset off);

Parameter(s):

• ZoneOffset off – represents the zone offset to merge with this LocalDateTime.

Return value:

The return type of this method is OffsetDateTime, it returns OffsetDateTime object that holds the value merged this LocalDateTime with the given offset.

Example:

// Java program to demonstrate the example 
// of atOffset(ZoneOffset off) method 
// of LocalDateTime

import java.time.*;

public class AtOffsetOfLocalDateTime {
    public static void main(String args[]) {
        // Instantiates two LocalDateTime
        // and a ZonedOffset
        LocalDateTime da_ti1 = LocalDateTime.parse("2005-10-05T10:10:10");
        LocalDateTime da_ti2 = LocalDateTime.now();
        ZoneOffset off = ZoneOffset.ofHoursMinutes(2, 2);

        // Display da_ti1, da_ti2
        // and off
        System.out.println("LocalDateTime da_ti1 and da_ti2: ");
        System.out.println("da_ti1: " + da_ti1);
        System.out.println("da_ti2: " + da_ti2);

        System.out.println();

        // Here, this method creates an OffsetDateTime
        // by merging this date-time (da_ti1) with
        // the given offset (off) i.e. 
        // da_ti1 + off(in hours , in minutes)
        OffsetDateTime off_da_time = da_ti1.atOffset(off);

        // Display updated off_da_time
        System.out.println("da_ti1.atOffset(off): " + off_da_time);

        // Here, this method creates an OffsetDateTime
        // by merging this date-time (da_ti2) with
        // the given offset (off) i.e. 
        // da_ti2 + off(in hours)
        off_da_time = da_ti2.atOffset(ZoneOffset.ofHours(4));

        // Display updated off_da_time
        System.out.print("da_ti2.atOffset(ZoneOffset.ofHours(4)): ");
        System.out.println(off_da_time);
    }
}

Output

LocalDateTime da_ti1 and da_ti2: 
da_ti1: 2005-10-05T10:10:10
da_ti2: 2020-06-04T08:02:20.579734

da_ti1.atOffset(off): 2005-10-05T10:10:10+02:02
da_ti2.atOffset(ZoneOffset.ofHours(4)): 2020-06-04T08:02:20.579734+04:00