记录bug blog
Search K

Appearance

Return to top
On this page

Java 日期类型全解析：LocalDate、Date、Calendar 的关系与互转工具类

在 Java 开发中，处理日期和时间是一个常见但又容易让人“踩坑”的任务。尤其是面对 java.util.Date、java.util.Calendar 和 java.time.LocalDate 这三个看似功能重叠的类时，很多开发者都会感到困惑：

它们到底有什么区别？
为什么 Java 要设计这么多日期类？
我该用哪个？怎么互相转换？

本文将为你彻底理清这三者的来龙去脉，并提供一个生产级可用的日期转换工具类，助你告别混乱，拥抱现代 Java 时间 API。

一、三大日期类型的“前世今生”

1. java.util.Date —— 最早的“时间戳”（JDK 1.0）

  • 本质：表示从 1970-01-01 00:00:00 UTC 开始的毫秒数（即时间戳）。
  • 问题：
    • 名字叫 Date，却包含时分秒毫秒，语义不清。
    • 方法设计反人类（如 getYear() 返回的是 1900 年起的偏移）。
    • 非线程安全。
    • 无法直观操作“年月日”。
java
Date date = new Date(); // 实际是当前时刻的时间戳

2. java.util.Calendar —— 对 Date 的“补丁”（JDK 1.1）

  • 目的：解决 Date 无法灵活操作日期字段的问题。
  • 特点：
    • 抽象类，通常使用 GregorianCalendar 实现。
    • 支持获取/设置年、月、日等字段。
    • 月份从 0 开始（January = 0），极易出错！
    • 同样非线程安全，API 冗长。
java
Calendar cal = Calendar.getInstance();
cal.set(2025, Calendar.DECEMBER, 18); // 注意：DECEMBER = 11

💡 虽然 Calendar 比 Date 更强大，但它只是“打补丁”，并未解决根本问题。

3. java.time.LocalDate —— 现代化方案（Java 8+，JSR-310）

  • 引入时间：Java 8（2014 年）
  • 设计理念：
    • 不可变对象 → 线程安全 ✅
    • 职责单一：LocalDate 只表示“日期”（年-月-日），不含时间与时区
    • 配套类丰富：LocalDateTime、ZonedDateTime、Instant 等各司其职
    • API 清晰、链式调用、支持 Lambda
java
LocalDate today = LocalDate.now(); // 2025-12-18
LocalDate specific = LocalDate.of(2025, 12, 18);

✅ 强烈推荐在新项目中使用 java.time 包！

二、三者关系总结

类型所属时代是否含时间是否含时区线程安全推荐使用
DateJDK 1.0✅（毫秒级）❌（隐含 UTC）❌❌（仅维护旧系统）
CalendarJDK 1.1✅✅（通过 TimeZone）❌❌
LocalDate / java.time.*Java 8+❌（LocalDate）/✅（LocalDateTime）❌（Local*）/✅（Zoned*）✅✅

📌 一句话总结：
Date 是时间戳，Calendar 是对它的笨重封装，而 LocalDate 是 Java 8 带来的清晰、安全、现代化的日期表示方式。

三、互转工具类（生产可用）

由于历史原因，我们仍需在新旧 API 之间转换。下面是一个完整、线程安全、注释清晰的工具类，支持所有常见转换和格式化操作。

✅ DateUtils.java

java
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.Calendar;
import java.util.Date;
import java.util.TimeZone;

/**
 * 日期转换工具类：支持 Date、Calendar 与 java.time（LocalDate/LocalDateTime）之间的互转
 */
public final class DateUtils {

    private DateUtils() {
        throw new UnsupportedOperationException("Utility class");
    }

    // ==============================
    // Date 转换
    // ==============================

    public static LocalDate toLocalDate(Date date) {
        return date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
    }

    public static LocalDateTime toLocalDateTime(Date date) {
        return date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
    }

    public static ZonedDateTime toZonedDateTime(Date date) {
        return date.toInstant().atZone(ZoneId.systemDefault());
    }

    // ==============================
    // Calendar 转换
    // ==============================

    public static LocalDate toLocalDate(Calendar calendar) {
        return calendar.toInstant()
                .atZone(calendar.getTimeZone().toZoneId())
                .toLocalDate();
    }

    public static LocalDateTime toLocalDateTime(Calendar calendar) {
        return calendar.toInstant()
                .atZone(calendar.getTimeZone().toZoneId())
                .toLocalDateTime();
    }

    public static Date toDate(Calendar calendar) {
        return calendar.getTime();
    }

    // ==============================
    // LocalDate / LocalDateTime 转 Date
    // ==============================

    public static Date toDate(LocalDate localDate) {
        return Date.from(localDate.atStartOfDay(ZoneId.systemDefault()).toInstant());
    }

    public static Date toDate(LocalDateTime localDateTime) {
        return Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());
    }

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

    // ==============================
    // 格式化
    // ==============================

    private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd");
    private static final DateTimeFormatter DATE_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    public static String format(LocalDate date) {
        return date.format(DATE_FORMATTER);
    }

    public static String format(LocalDateTime dateTime) {
        return dateTime.format(DATE_TIME_FORMATTER);
    }

    public static String formatDate(Date date) {
        return toLocalDate(date).format(DATE_FORMATTER);
    }

    public static String formatDateTime(Date date) {
        return toLocalDateTime(date).format(DATE_TIME_FORMATTER);
    }

    public static LocalDate parseLocalDate(String dateString) {
        return LocalDate.parse(dateString, DATE_FORMATTER);
    }

    public static LocalDateTime parseLocalDateTime(String dateTimeString) {
        return LocalDateTime.parse(dateTimeString, DATE_TIME_FORMATTER);
    }

    // ==============================
    // 快捷方法
    // ==============================

    public static LocalDate nowLocalDate() {
        return LocalDate.now();
    }

    public static LocalDateTime nowLocalDateTime() {
        return LocalDateTime.now();
    }

    public static Date nowDate() {
        return new Date();
    }
}

🔧 使用示例

java
public class Demo {
    public static void main(String[] args) {
        // Date → LocalDate
        Date now = new Date();
        LocalDate ld = DateUtils.toLocalDate(now);
        System.out.println("格式化日期: " + DateUtils.format(ld)); // 2025-12-18

        // 字符串 → LocalDate
        LocalDate parsed = DateUtils.parseLocalDate("2025-12-18");

        // LocalDate → Date
        Date date = DateUtils.toDate(parsed);

        // Calendar 转 LocalDateTime
        Calendar cal = Calendar.getInstance();
        LocalDateTime ldt = DateUtils.toLocalDateTime(cal);
    }
}

四、最佳实践建议

  1. 新项目一律使用 java.time（LocalDate、LocalDateTime 等）。
  2. 避免在业务逻辑中使用 Date 或 Calendar。
  3. 如果必须与旧系统交互（如 JDBC、某些 ORM 框架），仅在边界层做最小化转换。
  4. 所有转换默认使用系统默认时区，若需指定时区（如 UTC），可扩展工具类加入 ZoneId 参数。

结语

Java 的日期 API 经历了从“混乱”到“优雅”的演进。理解 Date、Calendar 和 LocalDate 的关系，不仅能帮你写出更健壮的代码，也能在面试中展现你的技术深度。

上次更新于: