Date、LocalDate、LocalTime、LocalDateTime、DateTimeFormatter类

一、java.util.Date(旧日期类)

1. 介绍

java.util.Date,JDK1.0 诞生,大部分方法过时,开发只记住两个常用构造

  • 底层本质:保存一个毫秒值,代表距离 1970 年 1 月 1 日 00:00:00 UTC 的毫秒数

2. 两个核心构造

复制代码
// ① Date():创建当前系统时间的Date对象
Date d1 = new Date();

// ② Date(long date):传入毫秒值,构造指定时间
Date d2 = new Date(1000); // 1000ms = 1s

3. 常用方法

复制代码
d1.getTime(); // 获取对象内部的毫秒值
d1.setTime(long ms); // 修改毫秒值,改变时间

✅ 缺点:

  1. 可变对象,线程不安全
  2. 很多 getYear/getMonth 标记过时,月份从 0 开始,反人类
  3. 格式化需要 SimpleDateFormat,同样线程不安全

二、JDK8 新时间包 java.time(推荐!不可变、线程安全)

包含:LocalDate(只有日期:年月日)、LocalTime(只有时间:时分秒)、LocalDateTime(日期 + 时间)

特点:不可变对象,修改时间不会改变原对象,返回新对象

2.1 LocalDate(年月日)

创建对象
复制代码
// now():获取系统当前日期
LocalDate today = LocalDate.now();

// of():指定年月日创建
LocalDate day = LocalDate.of(2025, Month.AUGUST, 10);
// 也可以直接传数字 of(2025,8,10)
常用获取方法(截图表格)
复制代码
int year = day.getYear();               // 获取年份
Month m = day.getMonth();               // 获取Month枚举(AUGUST)
int month = day.getMonthValue();        // 获取数字月份 1~12
int dayOfMonth = day.getDayOfMonth();   // 获取当月第几天

2.2 LocalTime(时分秒)

复制代码
LocalTime nowTime = LocalTime.now();
LocalTime t = LocalTime.of(14,30,20); //时、分、秒

// 获取
t.getHour();
t.getMinute();
t.getSecond();

2.3 LocalDateTime(日期 + 时间,最常用)

复制代码
// 当前日期时间
LocalDateTime now = LocalDateTime.now();
// 指定构造
LocalDateTime dt = LocalDateTime.of(2025,8,10,14,30);

// LocalDate / LocalTime 互相转换
LocalDate date = dt.toLocalDate();
LocalTime time = dt.toLocalTime();

2.4 修改时间方法(plus /minus/with,返回新对象)

复制代码
LocalDateTime newDt = now.plusDays(3);    // +3天
LocalDateTime newDt2 = now.minusMonths(1); // -1个月
LocalDateTime newDt3 = now.withYear(2026); // 修改年份

三、DateTimeFormatter 格式化 & 解析

替代旧的 SimpleDateFormat,线程安全!

格式模板字母(牢记)

  • yyyy 4 位年
  • MM 2 位月份
  • dd 2 位日期
  • HH 24 小时制小时
  • mm 分钟
  • ss 秒

完整示例

复制代码
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class Example21 {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        // 1. 创建格式化器,指定模板
        DateTimeFormatter fm1 = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");

        // 方式1:LocalDateTime对象调用format
        System.out.println("方式1:" + now.format(fm1));
        // 方式2:格式化器对象调用format
        System.out.println("方式2:" + fm1.format(now));

        // ===== 解析:字符串 → LocalDateTime =====
        String str = "2024-08-15 11:40:35";
        DateTimeFormatter fm2 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        // parse解析字符串
        LocalDateTime ld = LocalDateTime.parse(str, fm2);
        System.out.println("解析结果:" + ld);
    }
}

⚠️ 注意:parse 的时候,字符串格式必须和 ofPattern 模板严格匹配,否则报错


四、新旧 API 对比总结

类 包 是否可变 线程安全 使用场景
Date java.util ✅可变 ❌不安全 老项目维护,不推荐新项目
LocalDate/LocalTime/LocalDateTime java.time ❌不可变 ✅安全 新项目首选
DateTimeFormatter java.time.format ❌不可变 ✅安全 日期格式化解析(替代 SimpleDateFormat)

五、高频易错点

  1. Date 的月份是 0 开始(0 代表 1 月);Local 系列月份是 1 开始,符合正常人思维
  2. Local 时间对象是不可变:plus/minus/with 必须接收返回值,原对象不变
  3. ofPattern 模板区分大小写:MM 是月份,mm 是分钟,写反直接出错
  4. parse 解析字符串,格式模板和文本必须一一对应
  5. 旧 SimpleDateFormat 不要在多线程共用;DateTimeFormatter 可以全局共用

六、速记口诀

旧 Date 存毫秒,大多方法已过时; Local 新包 JDK8,日期时间分开制; now 拿当前,of 指定值; getMonthValue 拿数字,getMonth 拿枚举; DateTimeFormatter 格式化,模板字母要熟记; yyyy 年 MM 月,HH 时 mm 分 ss 秒; format 转字符串,parse 反向来解析; 新类不可变,线程更安全。

相关推荐
hai_android3 小时前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
用户9338104348453 小时前
MyBatis-Plus LambdaQueryWrapper 隐式转换踩坑:不知不觉索引失效
java
用户3721574261353 小时前
Java 在 PDF 中查找关键词:获取页码和坐标,并高亮匹配结果
java
Forget the Dream3 小时前
Spring AI 2.0 系列(三):ChatClient 与 ChatModel:Spring AI 2.0 的两层职责
java·人工智能·spring·springai
Rain的Java大神之路4 小时前
把数组本身变成哈希表:原地哈希搞定 LeetCode 41「缺失的第一个正数」
java·后端·leetcode
山楂树の5 小时前
Java 泛型:泛型类、泛型方法、泛型接口与通配符
java·开发语言·笔记
跳跳的小古风6 小时前
前端转全栈:一条接口从前端请求到 SQL 完整流程
java·前端
jianqiang.xue7 小时前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
ikgy8 小时前
JAVA EE:4.多线程核心组件实战
java·java-ee
杨凯凡8 小时前
IT日报|2026-11-19:Oracle Java 紧急补丁、Optimizely 供应链攻击、GitHub 安全评估升级
java·oracle·github