Java 8 新日期时间 API 核心用法详解 | 极客日志

Javajava

Java 8 新日期时间 API 核心用法详解

Java 8 引入的 java.time 包解决了旧版日期 API 的设计缺陷。主要类包括 LocalDate、LocalTime 和 LocalDateTime，均为不可变类型。支持通过 now() 获取当前时间，of() 构造指定时间，parse() 解析字符串（默认遵循 ISO 8601）。使用 DateTimeFormatter 可自定义格式化规则。提供 plus/minus 系列方法调整时间，以及 Duration 和 Period 计算间隔。相比旧 API，新 API 线程安全且更易用。

猫巷少女发布于 2021/5/17更新于 2026/4/241 浏览

Java 8 新日期时间 API 核心用法详解

Java 8 新日期时间 API 核心用法详解

Java 8 引入了 java.time 包，彻底重构了日期和时间处理逻辑。相比旧的 Date 和 Calendar，新 API 修正了常量设计的不合理之处，例如月份范围统一为 1~~12，周范围 1~~7。更重要的是，新 API 中的类型几乎全部是不可变的（类似 String），线程安全且不易被意外修改。

核心类与创建方式

最常用的三个类是 LocalDate、LocalTime 和 LocalDateTime。它们分别代表日期、时间和本地日期时间。

我们可以通过系统时钟直接获取当前时间，也可以通过静态工厂方法 of() 精确构造特定时刻。

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;

public class Demo {
    public static void main(String[] args) {
        // 获取当前时间
        LocalDateTime dt = LocalDateTime.now();
        LocalDate d = LocalDate.now();
        LocalTime t = LocalTime.now();
        
        System.out.println("dt = " + dt);
        System.out.println("d = " + d);
        System.out.println("t = " + t);

        // 构造特定时间
        LocalDate d2 = LocalDate.of(2019, 11, 30);
        LocalTime t2 = LocalTime.of(15, 16, 17);
        LocalDateTime   LocalDateTime.of(, , , , , );
        
        
           LocalDateTime.of(d2, t2);
        System.out.println( + dt2);
        System.out.println( + dt3);
    }
}

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

public class Demo {
    public static void main(String[] args) {
        // 标准格式解析 (ISO 8601)
        LocalDateTime dt = LocalDateTime.parse("1995-10-02T10:20:20");
        System.out.println(dt);

        // 自定义格式输出
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        System.out.println(dtf.format(LocalDateTime.now()));

        // 自定义格式解析
        LocalDateTime dt1 = LocalDateTime.parse("2021-02-17 10:21:11", dtf);
        System.out.println(dt1);
    }
}

import java.time.LocalDateTime;

public class Demo {
    public static void main(String[] args) {
        LocalDateTime dt = LocalDateTime.now();
        
        // 链式调用进行调整
        System.out.println(dt.plusDays(20).minusHours(3).minusMonths(1));

        // 设置具体字段
        System.out.println(dt.withDayOfMonth(31));
        System.out.println(dt.withMonth(9));

        // 比较前后顺序
        LocalDateTime dt1 = LocalDateTime.of(2021, 1, 1, 0, 0, 0);
        LocalDateTime dt2 = LocalDateTime.of(2021, 1, 2, 0, 0, 0);
        System.out.println(dt1.isBefore(dt2));
    }
}

import java.time.Duration;
import java.time.Period;
import java.time.LocalDate;
import java.time.LocalDateTime;

public class Demo {
    public static void main(String[] args) {
        LocalDateTime dt1 = LocalDateTime.of(2021, 1, 1, 0, 0, 0);
        LocalDateTime dt2 = LocalDateTime.of(2021, 1, 1, 1, 0, 0);

        // 时刻差
        Duration duration = Duration.between(dt1, dt2);
        System.out.println("duration = " + duration);

        // 日期差
        Period p = LocalDate.now().until(LocalDate.of(2022, 1, 9));
        System.out.println("p = " + p);

        // 直接创建 Duration
        Duration d1 = Duration.ofHours(10);
        Duration d3 = Duration.parse("P1DT2H3M");
        System.out.println("d3 = " + d3);
    }
}