将 java.util.Date 转换为 java.time.LocalDate

Question

将 java.util.Date 对象转换为新的 JDK 8/JSR-310 java.time.LocalDate 的最佳方法是什么？

 Date input = new Date();
LocalDate date = ???

原文由 JodaStephen 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

简答

Date input = new Date();
LocalDate date = input.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

解释

尽管它的名字， java.util.Date 代表时间线上的一个瞬间，而不是一个“日期”。对象中存储的实际数据是 long 自 1970-01-01T00:00Z（1970 GMT/UTC 午夜开始）以来的毫秒数。

JSR-310 中 java.util.Date 的等效类是 Instant ，因此有一个方便的方法 toInstant() 提供转换：–

 Date input = new Date();
Instant instant = input.toInstant();

A java.util.Date 实例没有时区概念。如果您在 toString() java.util.Date 这可能看起来很奇怪，因为 toString 是相对于时区的然而，该方法实际上使用 Java 的默认时区来提供字符串。时区不是 java.util.Date 实际状态的一部分。

Instant 也不包含有关时区的任何信息。因此，要将 Instant 转换为本地日期，必须指定时区。这可能是默认时区 - ZoneId.systemDefault() 或者它可能是您的应用程序控制的时区，例如用户首选项中的时区。使用 atZone() 方法应用时区：

 Date input = new Date();
Instant instant = input.toInstant();
ZonedDateTime zdt = instant.atZone(ZoneId.systemDefault());

A ZonedDateTime 包含由本地日期和时间、时区以及与 GMT/UTC 的偏移量组成的状态。因此，日期 - LocalDate 可以使用 toLocalDate() 轻松提取：

 Date input = new Date();
Instant instant = input.toInstant();
ZonedDateTime zdt = instant.atZone(ZoneId.systemDefault());
LocalDate date = zdt.toLocalDate();

Java 9 答案

在 Java SE 9 中，添加了一个 新方法 来稍微简化此任务：

 Date input = new Date();
LocalDate date = LocalDate.ofInstant(input.toInstant(), ZoneId.systemDefault());

这个新的替代方案更直接，产生的垃圾更少，因此性能应该更好。

原文由 JodaStephen 发布，翻译遵循 CC BY-SA 3.0 许可协议

Answer 2

更好的方法是：

 Date date = ...;
Instant.ofEpochMilli(date.getTime()).atZone(ZoneId.systemDefault()).toLocalDate()

这个版本的优点：

• 无论输入是 --- 的实例还是 java.util.Date java.sql.Date 子类（与@JodaStephen 的方式不同），都可以正常工作。这对于 JDBC 生成的数据很常见。 java.sql.Date.toInstant() 总是抛出异常。

• 对于带有 JSR-310 backport 的 JDK8 和 JDK7 是一样的

我个人使用实用程序类（但它不向后兼容）：

 /**
 * Utilities for conversion between the old and new JDK date types
 * (between {@code java.util.Date} and {@code java.time.*}).
 *
 * <p>
 * All methods are null-safe.
 */
public class DateConvertUtils {

    /**
     * Calls {@link #asLocalDate(Date, ZoneId)} with the system default time zone.
     */
    public static LocalDate asLocalDate(java.util.Date date) {
        return asLocalDate(date, ZoneId.systemDefault());
    }

    /**
     * Creates {@link LocalDate} from {@code java.util.Date} or it's subclasses. Null-safe.
     */
    public static LocalDate asLocalDate(java.util.Date date, ZoneId zone) {
        if (date == null)
            return null;

        if (date instanceof java.sql.Date)
            return ((java.sql.Date) date).toLocalDate();
        else
            return Instant.ofEpochMilli(date.getTime()).atZone(zone).toLocalDate();
    }

    /**
     * Calls {@link #asLocalDateTime(Date, ZoneId)} with the system default time zone.
     */
    public static LocalDateTime asLocalDateTime(java.util.Date date) {
        return asLocalDateTime(date, ZoneId.systemDefault());
    }

    /**
     * Creates {@link LocalDateTime} from {@code java.util.Date} or it's subclasses. Null-safe.
     */
    public static LocalDateTime asLocalDateTime(java.util.Date date, ZoneId zone) {
        if (date == null)
            return null;

        if (date instanceof java.sql.Timestamp)
            return ((java.sql.Timestamp) date).toLocalDateTime();
        else
            return Instant.ofEpochMilli(date.getTime()).atZone(zone).toLocalDateTime();
    }

    /**
     * Calls {@link #asUtilDate(Object, ZoneId)} with the system default time zone.
     */
    public static java.util.Date asUtilDate(Object date) {
        return asUtilDate(date, ZoneId.systemDefault());
    }

    /**
     * Creates a {@link java.util.Date} from various date objects. Is null-safe. Currently supports:<ul>
     * <li>{@link java.util.Date}
     * <li>{@link java.sql.Date}
     * <li>{@link java.sql.Timestamp}
     * <li>{@link java.time.LocalDate}
     * <li>{@link java.time.LocalDateTime}
     * <li>{@link java.time.ZonedDateTime}
     * <li>{@link java.time.Instant}
     * </ul>
     *
     * @param zone Time zone, used only if the input object is LocalDate or LocalDateTime.
     *
     * @return {@link java.util.Date} (exactly this class, not a subclass, such as java.sql.Date)
     */
    public static java.util.Date asUtilDate(Object date, ZoneId zone) {
        if (date == null)
            return null;

        if (date instanceof java.sql.Date || date instanceof java.sql.Timestamp)
            return new java.util.Date(((java.util.Date) date).getTime());
        if (date instanceof java.util.Date)
            return (java.util.Date) date;
        if (date instanceof LocalDate)
            return java.util.Date.from(((LocalDate) date).atStartOfDay(zone).toInstant());
        if (date instanceof LocalDateTime)
            return java.util.Date.from(((LocalDateTime) date).atZone(zone).toInstant());
        if (date instanceof ZonedDateTime)
            return java.util.Date.from(((ZonedDateTime) date).toInstant());
        if (date instanceof Instant)
            return java.util.Date.from((Instant) date);

        throw new UnsupportedOperationException("Don't know hot to convert " + date.getClass().getName() + " to java.util.Date");
    }

    /**
     * Creates an {@link Instant} from {@code java.util.Date} or it's subclasses. Null-safe.
     */
    public static Instant asInstant(Date date) {
        if (date == null)
            return null;
        else
            return Instant.ofEpochMilli(date.getTime());
    }

    /**
     * Calls {@link #asZonedDateTime(Date, ZoneId)} with the system default time zone.
     */
    public static ZonedDateTime asZonedDateTime(Date date) {
        return asZonedDateTime(date, ZoneId.systemDefault());
    }

    /**
     * Creates {@link ZonedDateTime} from {@code java.util.Date} or it's subclasses. Null-safe.
     */
    public static ZonedDateTime asZonedDateTime(Date date, ZoneId zone) {
        if (date == null)
            return null;
        else
            return asInstant(date).atZone(zone);
    }

}

这里的 asLocalDate() 方法是空安全的，使用 toLocalDate() ，如果输入是 java.sql.Date ), 否则采用上述方法。

原文由 Oliv 发布，翻译遵循 CC BY-SA 4.0 许可协议