Java 8 – Convert Date to LocalDate and LocalDateTime

The java.util.Date has no concept of time zone, and only represents the number of seconds passed since the Unix epoch time – 1970-01-01T00:00:00Z (midnight at the start of January 1, 1970 GMT/UTC)

Note
The new Java 8 java.time.Instant is the equivalent class to the classic java.util.Date

1. Date -> java.time

The idea for the date conversion :

Date -> Instant + System default time zone = LocalDate
Date -> Instant + System default time zone = LocalDateTime
Date -> Instant + System default time zone = ZonedDateTime

This example shows you how to convert java.util.Date to the new Java 8 Date APIs – LocalDate, LocalDateTime and ZonedDateTime

DateToJavaTime.java

package com.mkyong.java8;

import java.time.*;
import java.util.Date;

public class DateToJavaTime {

    public static void main(String[] args) {

        //Asia/Kuala_Lumpur +8
        ZoneId defaultZoneId = ZoneId.systemDefault();
        System.out.println("System Default TimeZone : " + defaultZoneId);

        //toString() append +8 automatically.
        Date date = new Date();
        System.out.println("date : " + date);

        //1. Convert Date -> Instant
        Instant instant = date.toInstant();
        System.out.println("instant : " + instant); //Zone : UTC+0

        //2. Instant + system default time zone + toLocalDate() = LocalDate
        LocalDate localDate = instant.atZone(defaultZoneId).toLocalDate();
        System.out.println("localDate : " + localDate);

        //3. Instant + system default time zone + toLocalDateTime() = LocalDateTime
        LocalDateTime localDateTime = instant.atZone(defaultZoneId).toLocalDateTime();
        System.out.println("localDateTime : " + localDateTime);

        //4. Instant + system default time zone = ZonedDateTime
        ZonedDateTime zonedDateTime = instant.atZone(defaultZoneId);
        System.out.println("zonedDateTime : " + zonedDateTime);

    }

}

Output

System Default TimeZone : Asia/Kuala_Lumpur

date : Fri Aug 19 21:46:31 MYT 2016
instant : 2016-08-19T13:46:31.981Z

localDate : 2016-08-19
localDateTime : 2016-08-19T21:46:31.981
zonedDateTime : 2016-08-19T21:46:31.981+08:00[Asia/Kuala_Lumpur]

2. Explanation – Q&A

2.1 Question : If Date has no concept of time zone, why the time zone will be displayed while we print out the Date object? For example :


//Fri Aug 19 11:52:06 MYT 2016
System.out.println(new Date()); //MYT = my system default time zone

Answer : Check the java.uti.Date.toString() source code, if you print out the Date object, the system default time zone will be appended and display together.

java.util.Date

public String toString() {

        //...omitted...

        TimeZone zi = date.getZone();
        if (zi != null) {
            sb.append(zi.getDisplayName(date.isDaylightTime(), TimeZone.SHORT, Locale.US)); // zzz
        } else {
            sb.append("GMT");
        }
        sb.append(' ').append(date.getYear());  // yyyy
        return sb.toString();
}
Note
This behavior is a design flaw since JDK1.1, it makes a lot of confusion. Again, the java.util.Date doesn’t store any time zone info, but if you print it out, the system default time zone will be displayed together.

2.2 Question : For the Date conversion, why we need to add a system default time zone for java.time.instant?
Answer : Refer to the above 2.1 Q&A. Review another example :

1. Date = 19/08/2016T10:00:00
2. System default time zone = +08:00 [Asia/Kuala_Lumpur]
3. Date (Print) = 19/08/2016T10:00:00+08:00 = 19/08/2016T18:00:00

The goal of the conversion is make sure both print Date and print LocalDate will generates the same output.

// Assume 19/08/2016T10:00:00 = 1000
// System default time zone = +8

1. Date (1000) -> Print Date (1000) = 1000+08:00  
// we always see "1000+08:00" (but the Date is still 1000)

2. Date (1000) -> Instant (1000)
// instant has no time zone or zero offset (UTC+0/Z)

3. Instant(1000) -> LocalDate(1000) -> Print LocalDate(1000) = 1000
// The result is "1000", different with print date!

4. LocalDate(1000) + 08:00 -> LocalDate(1000+08:00)
// add default time zone +8

5. Print LocalDate(1000+08:00) = 1000+08:00

3. java.time -> Date

This example shows you how to convert LocalDate, LocalDateTime and ZonedDateTime back to the classic java.util.Date

JavaTimeToDate.java

package com.mkyong.java8;

import java.time.*;
import java.util.Date;

public class JavaTimeToDate {

    public static void main(String[] args) {

        //Asia/Kuala_Lumpur +8
        ZoneId defaultZoneId = ZoneId.systemDefault();
        System.out.println("System Default TimeZone : " + defaultZoneId);

        LocalDate localDate = LocalDate.of(2016, 8, 19);
        Date date = Date.from(localDate.atStartOfDay(defaultZoneId).toInstant());
        System.out.println("\n1. LocalDate -> Date");
        System.out.println("localDate : " + localDate);
        System.out.println("date : " + date);

        LocalDateTime localDateTime = LocalDateTime.of(2016,8,19,21,46,31);
        Date date2 = Date.from(localDateTime.atZone(defaultZoneId).toInstant());
        System.out.println("\n2. LocalDateTime -> Date");
        System.out.println("localDateTime : " + localDateTime);
        System.out.println("date2 : " + date2);

        ZonedDateTime zonedDateTime = localDateTime.atZone(defaultZoneId);
        Date date3 = Date.from(zonedDateTime.toInstant());
        System.out.println("\n3. ZonedDateTime -> Date");
        System.out.println("zonedDateTime : " + zonedDateTime);
        System.out.println("date3 : " + date3);

    }

}

Output


System Default TimeZone : Asia/Kuala_Lumpur

1. LocalDate -> Date
localDate : 2016-08-19
date : Fri Aug 19 00:00:00 MYT 2016

2. LocalDateTime -> Date
localDateTime : 2016-08-19T21:46:31
date2 : Fri Aug 19 21:46:31 MYT 2016

3. ZonedDateTime -> Date
zonedDateTime : 2016-08-19T21:46:31+08:00[Asia/Kuala_Lumpur]
date3 : Fri Aug 19 21:46:31 MYT 2016

References

  1. JSR 310: Date and Time API
  2. Unix time
  3. Instant JavaDoc
  4. Date JavaDoc
  5. Java – Convert date and time between timezone

About the Author

author image
mkyong
Founder of Mkyong.com, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.

Comments

Leave a Reply

avatar
newest oldest most voted
Adam Hardy
Guest
Adam Hardy

Hi MKyong, nice article, but if you implement this in a system which might pass you a java.sql.Date and you try Date.toInstant(), then even java.util.Date will blow up with an UnsupportedOperationException.

I use: new java.sql.Date(src.getTime()).toLocalDate();