java.time.OffsetDateTime Class in Java

The OffsetDateTime class in Java represents a date and time with a fixed offset from UTC/Greenwich. It stores date and time fields with nanosecond precision along with the offset.

• OffsetDateTime belongs to the java.time package and is immutable and thread-safe.
• It provides methods to retrieve date and time fields such as year, month, day, hour, minute, second, and nanosecond.
• It also provides methods for comparing, formatting, adjusting, and performing date-time calculations.

Example: Program uses OffsetDateTime.now() to display the current date, time, and individual date-time fields.

import java.time.OffsetDateTime;

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

        OffsetDateTime dateTime = OffsetDateTime.now();

        System.out.println("Date and Time: " + dateTime);
        System.out.println("Year: " + dateTime.getYear());
        System.out.println("Month: " + dateTime.getMonth());
        System.out.println("Day: " + dateTime.getDayOfWeek());
        System.out.println("Hour: " + dateTime.getHour());
        System.out.println("Minute: " + dateTime.getMinute());
        System.out.println("Second: " + dateTime.getSecond());
    }
}

Date and Time: 2026-09-08T04:20:55.125272274Z
Year: 2026
Month: SEPTEMBER
Day: TUESDAY
Hour: 4
Minute: 20
Second: 55

Explanation: The program creates an OffsetDateTime object using the system clock and then uses methods such as getYear(), getMonth(), getDayOfWeek(), getHour(), getMinute(), and getSecond() to retrieve the corresponding values.

Syntax

public final class OffsetDateTime extends Object implements Temporal, TemporalAdjuster, Comparable<OffsetDateTime>, Serializable

Methods to Get Date and Time Fields from OffsetDateTime

The OffsetDateTime class provides individual getter methods for accessing different parts of a date-time. The following examples demonstrate retrieving date-related and time-related fields from the current date-time.

1. Get Year, Month and Day of Week

The getYear(), getMonth(), and getDayOfWeek() methods retrieve the year, month, and day of the week from an OffsetDateTime object. The now() method first obtains the current date and time from the system clock.

import java.time.OffsetDateTime;

public class GFG{

    public static void main(String[] args)
    {

        OffsetDateTime offsetDateTime = OffsetDateTime.now();

        System.out.println(offsetDateTime);

        System.out.println("Year  : " + offsetDateTime.getYear()
            + " | Month : " + offsetDateTime.getMonth()
            + " | Day : " + offsetDateTime.getDayOfWeek());
    }
}

2026-09-08T04:04:53.152921914Z
Year  : 2026 | Month : SEPTEMBER | Day : TUESDAY

Explanation: The program creates an OffsetDateTime object using now(). It then uses getYear(), getMonth(), and getDayOfWeek() to retrieve the year, month, and day of the week. The actual output depends on the system date and time.

2. Get Hour, Minute, Second and Nanosecond

The getHour(), getMinute(), getSecond(), and getNano() methods retrieve individual time fields from an OffsetDateTime object. These methods provide the time components separately.

import java.time.OffsetDateTime;

public class GFG {

    public static void main(String[] args) {

        OffsetDateTime offsetDateTime = OffsetDateTime.now();

        System.out.println(offsetDateTime);

        System.out.println(
            "Hour : " + offsetDateTime.getHour()
            + " | Minute : " + offsetDateTime.getMinute()
            + " | Second : " + offsetDateTime.getSecond()
            + " | NanoSecond : " + offsetDateTime.getNano()
        );
    }
}

2026-09-08T04:06:05.835923202Z
Hour : 4 | Minute : 6 | Second : 5 | NanoSecond : 835923202

Explanation: The program obtains the current OffsetDateTime and retrieves its hour, minute, second, and nanosecond values. The exact values vary according to the system clock.

Commonly Used Methods of OffsetDateTime