Course contentsShow
← Java
Lesson 1868 of 2,87038. Date and Time API (java.time)Free lesson

Creating OffsetDateTime Instances

Using OffsetDateTime.now(), of(), and parse() to create instances with specific offsets from UTC like +05:30 or -08:00.

Creating OffsetDateTime Instances

You'll learn how to construct OffsetDateTime objects using the three primary factory methods: now(), of(), and parse().

The Core Idea

An OffsetDateTime combines a local date-time with a fixed offset from UTC (like +05:30 or -08:00). Creating instances gives you precise control over representing moments in time with explicit zone offsets, without the complexity of full time zone rules.

Three Ways to Create OffsetDateTime

now(): Current Moment

The simplest approach captures the current date-time with your system's offset:

OffsetDateTime now = OffsetDateTime.now();
// Example: 2024-01-15T14:30:00+01:00

You can also specify a different zone:

OffsetDateTime nowInIndia = OffsetDateTime.now(ZoneId.of("Asia/Kolkata"));
// Uses +05:30 offset

of(): Building from Components

When you need a specific date-time at a particular offset, construct it piece by piece:

OffsetDateTime specific = OffsetDateTime.of(
    2024, 1, 15,           // year, month, day
    14, 30, 0, 0,          // hour, minute, second, nano
    ZoneOffset.of("+05:30")
);

You can also combine existing objects:

LocalDateTime localDT = LocalDateTime.of(2024, 1, 15, 14, 30);
ZoneOffset offset = ZoneOffset.of("-08:00");
OffsetDateTime combined = OffsetDateTime.of(localDT, offset);

parse(): From ISO-8601 Strings

Convert standard date-time strings with offset notation:

OffsetDateTime parsed = OffsetDateTime.parse("2024-01-15T14:30:00+05:30");
OffsetDateTime westCoast = OffsetDateTime.parse("2024-01-15T14:30:00-08:00");

Think of It This Way

Creating an OffsetDateTime is like setting a precise appointment: you specify when (date and time) and where (the UTC offset), giving you an unambiguous point in time.

Key Takeaway: Use now() for the current moment, of() to construct specific instances with explicit offsets like +05:30 or -08:00, and parse() to convert ISO-8601 formatted strings into OffsetDateTime objects.