Java利用LocalDate进行日期处理的完全指南

// 反人类设计的经典示例
Date date = new Date(122, 10, 21); 
// 实际表示：2022年11月21日（年份基准是1900，月份从0开始）

// 获取当前日期（无时区概念，基于系统时钟）
LocalDate today = LocalDate.now(); 

// 指定具体日期（月份使用枚举，避免数值歧义）
LocalDate nationalDay = LocalDate.of(2023, Month.OCTOBER, 1);

// 解析标准ISO格式字符串（yyyy-MM-dd）
LocalDate parsedDate = LocalDate.parse("2023-08-15");

// 创建线程安全的格式化器（推荐重用实例）
DateTimeFormatter formatter = DateTimeFormatter
    .ofPattern("yyyy年MM月dd日") // 定义格式模板
    .withLocale(Locale.CHINA);    // 指定地区设置

// 格式化日期对象 → 字符串
String formatted = nationalDay.format(formatter); // 输出："2023年10月01日"

// 解析字符串 → 日期对象
LocalDate date = LocalDate.parse("2023年10月01日", formatter);

// 基础计算（返回新对象，原对象不变）
LocalDate tomorrow = today.plusDays(1);      // 加1天
LocalDate prevMonth = today.minusMonths(1);  // 减1个月

// 使用时间调节器（TemporalAdjusters）
LocalDate firstDayOfMonth = today.with(TemporalAdjusters.firstDayOfMonth());
LocalDate nextMonday = today.with(TemporalAdjusters.next(DayOfWeek.MONDAY));

// 比较日期先后
boolean isAfter = today.isAfter(nationalDay); 

// 判断闰年（基于ISO日历系统）
boolean isLeapYear = today.isLeapYear(); 

// 获取星期枚举（Monday-Sunday）
DayOfWeek dayOfWeek = today.getDayOfWeek(); 

// 计算两个日期之间的差值
LocalDate start = LocalDate.of(2023, 1, 1);
LocalDate end = LocalDate.of(2023, 12, 31);
Period period = Period.between(start, end);

// 格式化输出时间段
System.out.printf("相差：%d年%d个月%d天",
    period.getYears(),   // 年差
    period.getMonths(), // 月差
    period.getDays());   // 日差

// 转换为当天的零点时刻（系统默认时区）
ZonedDateTime zdt = today.atStartOfDay(ZoneId.systemDefault());
Date oldDate = Date.from(zdt.toInstant());

Date date = new Date();
// 转换步骤：Date → Instant → ZonedDateTime → LocalDate
LocalDate localDate = date.toInstant()       // 转为时间戳
    .atZone(ZoneId.systemDefault()) // 附加时区信息
    .toLocalDate();                 // 提取日期部分

@Entity
public class User {
    @Column(name = "birth_date")
    private LocalDate birthDate; // 直接映射为DATE类型
    
    @Column(name = "create_time")
    private LocalDateTime createTime; // 映射为TIMESTAMP
}

// 使用三方库如LunarDate
LunarDate lunarDate = LunarDate.fromSolar(2023, 8, 15);
LocalDate solarDate = lunarDate.toSolar();

long workDays = start.datesUntil(end)
    .filter(date -> date.getDayOfWeek().getValue() < 6)
    .count();