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

Converting Between OffsetDateTime and Other Types

Converting between OffsetDateTime, ZonedDateTime, LocalDateTime, and Instant using toInstant(), atZoneSameInstant(), and toLocalDateTime().

Converting Between OffsetDateTime and Other Types

You'll learn how to smoothly convert OffsetDateTime to and from related date-time types like ZonedDateTime, LocalDateTime, and Instant.

Why Conversions Matter

OffsetDateTime sits at an intersection in the java.time API. Sometimes you need the fixed offset precision it provides, but other times you need the richer time zone rules of ZonedDateTime, the simplicity of LocalDateTime, or the universal timeline of Instant. Knowing how to convert between these types lets you use the right tool for each situation.

Converting to Instant

Instant represents a moment on the universal timeline. Since OffsetDateTime includes offset information, converting to Instant is straightforward:

OffsetDateTime odt = OffsetDateTime.now();
Instant instant = odt.toInstant();

This gives you the same moment in time, expressed as seconds since the epoch.

Converting to ZonedDateTime

To convert to ZonedDateTime, use atZoneSameInstant(). This preserves the moment in time but applies a time zone's rules:

OffsetDateTime odt = OffsetDateTime.now();
ZonedDateTime zdt = odt.atZoneSameInstant(ZoneId.of("America/New_York"));

The wall-clock time might change to reflect the new zone, but you're still representing the same instant.

Converting to LocalDateTime

To drop the offset information entirely and get just the date-time components:

OffsetDateTime odt = OffsetDateTime.now();
LocalDateTime ldt = odt.toLocalDateTime();

Warning: This discards offset information, so use it only when local time is what matters.

Converting Back to OffsetDateTime

From Instant, provide an offset:

Instant instant = Instant.now();
OffsetDateTime odt = instant.atOffset(ZoneOffset.UTC);

From ZonedDateTime, use toOffsetDateTime() (covered after your current progress).

Key Takeaway: Use toInstant() for universal moments, atZoneSameInstant() for zone-aware conversions, and toLocalDateTime() when discarding offset information—each method preserves or transforms context appropriately.