Java日期时间API Date、LocalDate、LocalDateTime、SimpleDateFormat、DateTimeFormatter全攻略

import java.util.date;

// 1. 获取当前时间
date now = new date();
system.out.println(now);  // tue aug 18 14:30:25 cst 2026

// 2. 通过时间戳创建（毫秒）
date datefrommillis = new date(1723967425000l);

// 3. 获取/设置时间戳（可变！）
long timestamp = now.gettime();        // 毫秒级时间戳
now.settime(1723967425000l);          // ❌ 可变，破坏了不可变性

// ❌ 年份从 1900 开始计算，月份从 0 开始
date d = new date(2026 - 1900, 8 - 1, 18);  // 8月要写成 7！
system.out.println(d.getyear());   // 126（实际年份要 +1900）
system.out.println(d.getmonth());  // 7（实际月份要 +1）

// ❌ 方法大量被废弃
d.getyear();   // @deprecated
d.getmonth();  // @deprecated
d.getday();    // @deprecated

import java.time.localdate;

// ✅ 获取当前日期
localdate today = localdate.now();  // 2026-08-18

// ✅ 创建指定日期（符合直觉：年-月-日）
localdate date = localdate.of(2026, 8, 18);
localdate date2 = localdate.parse("2026-08-18");  // iso 标准格式

// ✅ 获取年月日
int year = date.getyear();        // 2026
int month = date.getmonthvalue(); // 8（注意是 getmonthvalue，不是 getmonth）
int day = date.getdayofmonth();   // 18
int dayofweek = date.getdayofweek().getvalue(); // 3（周三=3，周一=1）

localdate today = localdate.now();

localdate tomorrow = today.plusdays(1);           // 加 1 天
localdate nextmonth = today.plusmonths(1);        // 加 1 月
localdate nextyear = today.plusyears(1);          // 加 1 年
localdate lastweek = today.minusweeks(1);         // 减 1 周
localdate plusday = today.plusdays(100);           // 加 100 天

// 判断
boolean isafter = today.isafter(localdate.of(2026, 1, 1));  // true
boolean isleap = today.isleapyear();  // 判断闰年

// 链式调用
localdate future = today
    .plusyears(2)
    .minusmonths(3)
    .plusdays(10);  // 2028-05-28

// 统计当月天数
int daysinmonth = yearmonth.now().lengthofmonth();  // 31

// 判断是否为闰年
boolean isleap = localdate.now().isleapyear();  // false（2026 不是闰年）

// 获取某个月的第一天/最后一天
localdate firstday = localdate.of(2026, 8, 1);
localdate lastday = firstday.with(temporaladjusters.lastdayofmonth());  // 2026-08-31

import java.time.localdatetime;
import java.time.localdate;
import java.time.localtime;

// ✅ 获取当前日期时间
localdatetime now = localdatetime.now();  // 2026-08-18t14:30:25.123456789

// ✅ 从年月日时分秒创建
localdatetime dt = localdatetime.of(2026, 8, 18, 14, 30, 25);

// ✅ 由 localdate + localtime 组合
localdate date = localdate.of(2026, 8, 18);
localtime time = localtime.of(14, 30, 25);
localdatetime dt2 = localdatetime.of(date, time);

// ✅ 从字符串解析（iso 标准：t 分隔）
localdatetime parsed = localdatetime.parse("2026-08-18t14:30:25");

// ✅ 获取各字段
int year = now.getyear();
int month = now.getmonthvalue();
int day = now.getdayofmonth();
int hour = now.gethour();
int minute = now.getminute();
int second = now.getsecond();
int nano = now.getnano();

localdatetime now = localdatetime.now();

localdatetime later = now
    .plusyears(1)
    .plusmonths(2)
    .plusdays(3)
    .plushours(4)
    .plusminutes(5)
    .plusseconds(6);  // 链式调用，灵活直观

// 比较
boolean before = now.isbefore(localdatetime.of(2027, 1, 1, 0, 0));  // true
boolean after = now.isafter(localdatetime.now().minusdays(1));      // true

import java.time.localtime;

// ✅ 创建
localtime now = localtime.now();              // 14:30:25.123456789
localtime time = localtime.of(14, 30, 25);    // 14:30:25
localtime parsed = localtime.parse("14:30:25");

// ✅ 运算
localtime later = time.plushours(1).plusminutes(30).plusseconds(10);

// ✅ 获取字段
int hour = time.gethour();    // 14
int minute = time.getminute(); // 30
int second = time.getsecond(); // 25
int nano = time.getnano();

import java.text.simpledateformat;
import java.util.date;

// ❌ 危险：不能作为 static 共享
simpledateformat sdf = new simpledateformat("yyyy-mm-dd hh:mm:ss");

// 格式化：date → string
string str = sdf.format(new date());  // "2026-08-18 14:30:25"

// 解析：string → date
date date = sdf.parse("2026-08-18 14:30:25");  // 需处理 parseexception

// 方案1：每次新建（低频场景）
public string format(date date) {
    return new simpledateformat("yyyy-mm-dd").format(date);
}

// 方案2：threadlocal（推荐，性能最佳）
public class dateutils {
    private static final threadlocal<simpledateformat> tl = 
        threadlocal.withinitial(() -> new simpledateformat("yyyy-mm-dd"));
    
    public static string format(date date) {
        return tl.get().format(date);
    }
}

// 方案3：同步锁（不推荐，性能差）
synchronized (sdf) {
    sdf.format(date);
}

import java.time.localdatetime;
import java.time.format.datetimeformatter;

// ✅ 不可变，可定义为全局静态常量！
public static final datetimeformatter formatter = 
    datetimeformatter.ofpattern("yyyy-mm-dd hh:mm:ss");

// 格式化：localdatetime → string
localdatetime now = localdatetime.now();
string str = now.format(formatter);  // "2026-08-18 14:30:25"

// 解析：string → localdatetime
localdatetime dt = localdatetime.parse("2026-08-18 14:30:25", formatter);

// ✅ 使用预定义格式
string iso1 = localdatetime.now().format(datetimeformatter.iso_local_date_time);
string iso2 = localdate.now().format(datetimeformatter.iso_local_date);

// ✅ 自定义格式（中文）
datetimeformatter chineseformatter = 
    datetimeformatter.ofpattern("yyyy年mm月dd日 hh时mm分ss秒");
string str = localdatetime.now().format(chineseformatter);  // 2026年08月18日 14时30分25秒

// 常用格式示例
datetimeformatter.ofpattern("yyyy-mm-dd hh:mm:ss")      // 2026-08-18 14:30:25
datetimeformatter.ofpattern("yyyy年mm月dd日")          // 2026年08月18日
datetimeformatter.ofpattern("yyyy/mm/dd hh:mm")        // 2026/08/18 14:30
datetimeformatter.ofpattern("yyyy-mm-dd't'hh:mm:ss")   // 2026-08-18t14:30:25
datetimeformatter.ofpattern("yyyy-mm-dd hh:mm:ss.sss") // 2026-08-18 14:30:25.123
datetimeformatter.ofpattern("eee, mmm dd, yyyy")       // wed, aug 18, 2026

import java.time.*;
import java.util.date;

public class dateconverter {
    
    // ===== date ↔ localdate =====
    public static localdate datetolocaldate(date date) {
        return date.toinstant()
            .atzone(zoneid.systemdefault())
            .tolocaldate();
    }
    
    public static date localdatetodate(localdate localdate) {
        return date.from(localdate.atstartofday(zoneid.systemdefault()).toinstant());
    }
    
    // ===== date ↔ localdatetime =====
    public static localdatetime datetolocaldatetime(date date) {
        return date.toinstant()
            .atzone(zoneid.systemdefault())
            .tolocaldatetime();
    }
    
    public static date localdatetimetodate(localdatetime ldt) {
        return date.from(ldt.atzone(zoneid.systemdefault()).toinstant());
    }
    
    // ===== date ↔ instant =====
    public static instant datetoinstant(date date) {
        return date.toinstant();
    }
    
    public static date instanttodate(instant instant) {
        return date.from(instant);
    }
    
    // ===== localdatetime ↔ localdate =====
    public static localdate localdatetimetolocaldate(localdatetime ldt) {
        return ldt.tolocaldate();
    }
    
    public static localdatetime localdatetolocaldatetime(localdate ld) {
        return ld.atstartofday();  // 00:00:00
    }
}

// 问题 1：下面这段代码在高并发下会出现什么问题？
public class dateutils {
    public static final simpledateformat sdf = 
        new simpledateformat("yyyy-mm-dd hh:mm:ss");
    
    public static string format(date date) {
        return sdf.format(date);
    }
}

// 问题 2：下面代码分别输出什么？
localdate date = localdate.of(2026, 8, 18);
system.out.println(date.getmonthvalue());    // a
system.out.println(date.getmonth());         // b

date d = new date(126, 7, 18);
system.out.println(d.getmonth() + 1);        // c

// 问题 3：下面两种方式，哪一种性能更好、更安全？
// 方式 a
datetimeformatter formatter = datetimeformatter.ofpattern("yyyy-mm-dd");
string str = localdate.now().format(formatter);

// 方式 b
string str = localdate.now().format(datetimeformatter.ofpattern("yyyy-mm-dd"));