How to Convert Between ZonedDateTime and Date in Java

Last updated: May 12, 2024

Written by: Nam Tien Vu

Reviewed by: Andrea Cerasoni

Java Dates

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

Distributed systems often come with complex challenges such as service-to-service communication, state management, asynchronous messaging, security, and more.

Dapr (Distributed Application Runtime) provides a set of APIs and building blocks to address these challenges, abstracting away infrastructure so we can focus on business logic.

In this tutorial, we'll focus on Dapr's pub/sub API for message brokering. Using its Spring Boot integration, we'll simplify the creation of a loosely coupled, portable, and easily testable pub/sub messaging system:

>> Flexible Pub/Sub Messaging With Spring Boot and Dapr

1. Overview

When working with Java applications that handle date and time, understanding how to convert between different types is often essential.

In this tutorial, we’ll explore how to convert between ZonedDateTime and Date in Java.

2. Understanding ZonedDateTime and Date

Before diving into conversions, let’s understand the core concepts of ZonedDateTime and Date in Java. This will help us know when and why to convert between these two types.

2.1. ZonedDateTime

ZonedDateTime is part of the Java Date and Time API introduced in Java 8. A ZonedDateTime object contains:

A local date and time (year, month, day, hour, minute, second, nanosecond)
A timezone (represented by ZoneId)
An offset from UTC/Greenwich

This makes ZonedDateTime incredibly useful for applications that require handling different time zones.

2.2. Date

The Date class is a part of the original date and time API from Java’s early versions. It represents a specific instant in time with millisecond precision beginning from the UNIX epoch (January 1, 1970, 00:00:00 GMT).

Date does not contain any time zone information. It is essentially timezone-agnostic, always representing a point in time in UTC. This can lead to confusion if developers mistakenly interpret Date as representing a time in the local time zone.

3. Converting ZonedDateTime to Date

To convert a ZonedDateTime to a Date, we first need to convert the ZonedDateTime to an Instant, as both ZonedDateTime and Instant represent points on the timeline suitable for conversion. Let’s see how we do it:

public static Date convertToDate(ZonedDateTime zonedDateTime) {
    return Date.from(zonedDateTime.toInstant());
}

4. Converting Date to ZonedDateTime

Converting back from a Date to a ZonedDateTime also involves getting an Instant from the Date and then specifying the time zone we want the ZonedDateTime to have:

public static ZonedDateTime convertToZonedDateTime(Date date, ZoneId zone) {
    return date.toInstant().atZone(zone);
}

In this conversion, it’s important to specify the time zone (ZoneId) because a Date object doesn’t contain timezone information. We can get our system’s default ZoneId with the static method ZoneId.systemDefault().

5. Testing Our Methods

Let’s write some unit tests using JUnit to ensure our conversion methods work correctly:

@Test
public void givenZonedDateTime_whenConvertToDate_thenCorrect() {
    ZonedDateTime zdt = ZonedDateTime.now(ZoneId.of("UTC"));
    Date date = DateAndZonedDateTimeConverter.convertToDate(zdt);
    assertEquals(Date.from(zdt.toInstant()), date);
}

@Test
public void givenDate_whenConvertToZonedDateTime_thenCorrect() {
    Date date = new Date();
    ZoneId zoneId = ZoneId.of("UTC");
    ZonedDateTime zdt = DateAndZonedDateTimeConverter.convertToZonedDateTime(date, zoneId);
    assertEquals(date.toInstant().atZone(zoneId), zdt);
}

6. Conclusion

Converting between ZonedDateTime and Date in Java is straightforward once we understand how to handle the conversion points, namely Instant and ZoneId. While ZonedDateTime offers greater functionality and flexibility, Date remains useful in scenarios requiring integration with older Java codebases.

The code backing this article is available on GitHub. Once you're logged in as a Baeldung Pro Member, start learning and coding on the project.