Java日期时间方法一文讲清楚：核心类、格式化与常见问题有哪些？

日期时间处理中的错误大多来自对API特性理解不够。比如旧版Date对象明明表示一个时间点，却带有年月日字段，月份从0开始计数，年份需要减去1900；SimpleDateFormat在多线程环境下共享同一个实例会引发解析异常或结果错乱。要彻底摆脱这些坑，需要系统掌握Java日期时间方法的设计思路，尤其是java.time包中不可变且线程安全的类。本文围绕核心类、格式化与解析、常见问题三个层面展开，帮助你建立完整的知识框架。

Java日期时间API的演进与核心类

在Java 8之前，开发者主要依赖java.util.Date和java.util.Calendar处理日期时间。Date最大的问题是可变性，它本质上是一个时间戳，却混入了日期字段的读写方法，导致一段代码可以随意修改一个Date对象的年、月、日，破坏数据一致性。Calendar虽然补充了字段操作能力，但API设计冗长，获取年份要写calendar.get(Calendar.YEAR)，而且月份依然从0开始，极易造成理解偏差。

java.time包引入后，日期时间处理才真正变得清晰。核心类包括：LocalDate表示不带时间的日期，LocalTime表示不带日期的时间，LocalDateTime表示日期加时间，ZonedDateTime表示带时区的完整日期时间，Instant表示UTC时间线上的一个点。这些类都是不可变对象，所有修改方法都会返回新实例，天然适合多线程环境，不再需要额外的同步处理。

下面通过一段代码展示这些核心类的基本创建与读取方式。通过工厂方法now()可以获取当前时间，使用of()可以构造指定时间，字段读取则通过getYear()、getMonthValue()等直观方法完成。

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;
import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.Instant;

public class DateTimeDemo {
    public static void main(String[] args) {
        LocalDate date = LocalDate.now();
        LocalTime time = LocalTime.now();
        LocalDateTime dateTime = LocalDateTime.now();
        ZonedDateTime zoned = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
        Instant instant = Instant.now();

        System.out.println(date);
        System.out.println(time);
        System.out.println(dateTime);
        System.out.println(zoned);
        System.out.println(instant);

        LocalDate specific = LocalDate.of(2024, 5, 20);
        int year = specific.getYear();
        int month = specific.getMonthValue();
        int day = specific.getDayOfMonth();
        System.out.println(year + "-" + month + "-" + day);
    }
}

日期时间格式化与解析的正确姿势

格式化与解析是日期时间处理中最常出错的地方。传统做法使用SimpleDateFormat，但这个类并非线程安全。如果多个线程同时调用同一个SimpleDateFormat实例的format()或parse()方法，其内部的Calendar对象会被并发修改，轻则返回错误结果，重则抛出NumberFormatException或ArrayIndexOutOfBoundsException。修复手段通常是为每个线程创建独立实例，或者使用ThreadLocal包装，但增加维护成本。

更推荐的做法是使用DateTimeFormatter。这个类不可变且线程安全，可以安全地定义为静态常量在多个线程间共享。它支持两种创建方式：一种是通过ofPattern()传入自定义模式，比如yyyy-MM-dd HH:mm:ss；另一种是直接使用预定义的格式化器，如DateTimeFormatter.ISO_LOCAL_DATE、DateTimeFormatter.ISO_DATE_TIME等。下面的代码演示了自定义格式化和解析的完整流程。

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class FormatDemo {
    public static void main(String[] args) {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        LocalDateTime now = LocalDateTime.now();
        String formatted = now.format(formatter);
        System.out.println(formatted);

        LocalDateTime parsed = LocalDateTime.parse("2024-05-20 15:30:00", formatter);
        System.out.println(parsed);

        DateTimeFormatter isoFormatter = DateTimeFormatter.ISO_LOCAL_DATE;
        String isoDate = now.format(isoFormatter);
        System.out.println(isoDate);
    }
}

解析字符串时要特别注意格式与输入完全匹配，否则会抛出DateTimeParseException。如果输入可能包含多余空格或不同格式，建议先进行字符串预处理，或者使用DateTimeFormatterBuilder构建更宽松的解析规则。对于需要处理不同时区的场景，不要直接对LocalDateTime进行格式化后跨系统传输，而应该优先使用Instant或ZonedDateTime，避免时区信息丢失。

常见问题解答与最佳实践

日期加减是最常见的操作之一。LocalDate、LocalDateTime等类提供了plusDays()、plusMonths()、minusWeeks()等一系列方法。这些方法不会修改原对象，而是返回一个新的日期时间对象，因此可以连续调用而不必担心副作用。比如计算下个月的今天，可以直接写today.plusMonths(1)。当需要计算两个日期之间的差值时，可以使用ChronoUnit.DAYS.between()或者Period.between()。前者适合精确到天、小时、分钟等单位的差值，后者则返回年、月、日的组合描述。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
import java.time.temporal.TemporalAdjusters;
import java.time.Period;

public class DateOpsDemo {
    public static void main(String[] args) {
        LocalDate today = LocalDate.of(2024, 5, 20);
        LocalDate nextWeek = today.plusWeeks(1);
        LocalDate lastMonth = today.minusMonths(1);
        System.out.println(nextWeek);
        System.out.println(lastMonth);

        LocalDate start = LocalDate.of(2024, 1, 1);
        LocalDate end = LocalDate.of(2024, 12, 31);
        long days = ChronoUnit.DAYS.between(start, end);
        Period period = Period.between(start, end);
        System.out.println(days);
        System.out.println(period.getYears() + "年" + period.getMonths() + "月" + period.getDays() + "天");

        LocalDate lastDay = today.with(TemporalAdjusters.lastDayOfMonth());
        System.out.println(lastDay);
    }
}

跨时区转换也是高频需求。要把一个LocalDateTime赋予时区上下文，可以调用atZone()方法；要在不同时区之间转换同一时刻，则使用withZoneSameInstant()。例如将上海时间转换为纽约时间时，不能简单修改小时数，而应该依赖时区规则自动处理夏令时偏移。下面的代码演示了这种转换方式。

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZonedDateTime;

public class ZoneDemo {
    public static void main(String[] args) {
        LocalDateTime localDateTime = LocalDateTime.of(2024, 5, 20, 10, 0, 0);
        ZonedDateTime shanghaiTime = localDateTime.atZone(ZoneId.of("Asia/Shanghai"));
        ZonedDateTime newYorkTime = shanghaiTime.withZoneSameInstant(ZoneId.of("America/New_York"));
        System.out.println(shanghaiTime);
        System.out.println(newYorkTime);
    }
}

在实际项目中，还应避免继续使用Date和Calendar。新代码应统一使用java.time包，数据库持久层如果使用JDBC 4.2及以上版本，可以直接映射LocalDate、LocalDateTime等类型。对于旧版驱动，可以通过java.sql.Date.valueOf()或Timestamp.valueOf()进行转换。JSON序列化时，建议配置统一的日期格式并指定时区，避免前后端因时区不一致产生8小时偏移问题。掌握这些方法后，日期时间处理会变得稳定且易于维护。

Java日期时间LocalDateDateTimeFormatter修改时间：2026-08-28 19:57:30