编辑“︁Java LocalDate”︁

{{DISPLAYTITLE:Java LocalDate}}  
'''Java LocalDate''' 是 Java 日期时间 API（`java.time` 包）中的一个核心类，用于表示不带时间和时区的日期（年-月-日）。它是不可变的（immutable）且线程安全的，适用于处理仅需日期的场景，如生日、节假日或事件日期。  

== 概述 ==  
`LocalDate` 表示 ISO-8601 日历系统中的日期（默认格式为 `YYYY-MM-DD`），例如 `2023-10-05`。它不包含时间信息（如小时、分钟）或时区偏移量，因此适用于纯日期的计算和比较。  

=== 主要特性 ===  
* 不可变性：所有修改操作返回新实例，原对象不变。  
* 线程安全：无需额外同步。  
* 链式调用：支持方法链式操作（如 `plusDays().minusMonths()`）。  

== 创建 LocalDate 对象 ==  
以下是创建 `LocalDate` 实例的常见方式：  

=== 当前日期 ===  
<syntaxhighlight lang="java">  
LocalDate today = LocalDate.now();  
System.out.println("当前日期: " + today); // 输出示例: 2023-10-05  
</syntaxhighlight>  

=== 指定日期 ===  
<syntaxhighlight lang="java">  
LocalDate specificDate = LocalDate.of(2023, 10, 5);  
LocalDate parsedDate = LocalDate.parse("2023-10-05"); // 必须符合ISO格式  
System.out.println(specificDate); // 输出: 2023-10-05  
</syntaxhighlight>  

== 常用操作 ==  
=== 获取日期字段 ===  
<syntaxhighlight lang="java">  
LocalDate date = LocalDate.of(2023, 10, 5);  
int year = date.getYear();          // 2023  
Month month = date.getMonth();      // OCTOBER  
int day = date.getDayOfMonth();     // 5  
DayOfWeek dow = date.getDayOfWeek();// THURSDAY  
</syntaxhighlight>  

=== 日期加减 ===  
<syntaxhighlight lang="java">  
LocalDate tomorrow = today.plusDays(1);  
LocalDate nextMonth = today.plusMonths(1);  
LocalDate previousYear = today.minusYears(1);  
</syntaxhighlight>  

=== 日期比较 ===  
<syntaxhighlight lang="java">  
boolean isAfter = today.isAfter(LocalDate.parse("2023-01-01"));  
boolean isLeapYear = today.isLeapYear();  
</syntaxhighlight>  

== 实际应用案例 ==  
=== 案例1：计算两个日期之间的天数 ===  
<syntaxhighlight lang="java">  
LocalDate start = LocalDate.of(2023, 1, 1);  
LocalDate end = LocalDate.of(2023, 10, 5);  
long daysBetween = ChronoUnit.DAYS.between(start, end);  
System.out.println("相差天数: " + daysBetween); // 输出: 277  
</syntaxhighlight>  

=== 案例2：检查节假日 ===  
<syntaxhighlight lang="java">  
LocalDate dateToCheck = LocalDate.of(2023, 12, 25);  
if (dateToCheck.getMonth() == Month.DECEMBER && dateToCheck.getDayOfMonth() == 25) {  
    System.out.println("这是圣诞节！");  
}  
</syntaxhighlight>  

== 高级用法 ==  
=== 自定义日期格式 ===  
使用 `DateTimeFormatter` 解析或格式化日期：  
<syntaxhighlight lang="java">  
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");  
String formattedDate = today.format(formatter); // 输出: 05/10/2023  
LocalDate parsedDate = LocalDate.parse("05/10/2023", formatter);  
</syntaxhighlight>  

=== 日期范围检查 ===  
<syntaxhighlight lang="java">  
LocalDate date = LocalDate.of(2023, 2, 30); // 抛出DateTimeException: 无效日期  
</syntaxhighlight>  

== 与其他类的交互 ==  
=== 转换为 LocalDateTime ===  
<syntaxhighlight lang="java">  
LocalDateTime dateTime = today.atTime(14, 30); // 2023-10-05T14:30  
</syntaxhighlight>  

=== 转换为 ZonedDateTime ===  
<syntaxhighlight lang="java">  
ZonedDateTime zoned = today.atStartOfDay(ZoneId.of("Europe/Paris"));  
</syntaxhighlight>  

== 性能与最佳实践 ==  
* 优先使用 `LocalDate` 而非 `java.util.Date` 或 `Calendar`（旧API）。  
* 避免频繁创建 `DateTimeFormatter` 实例（可缓存复用）。  

<mermaid>  
graph TD  
    A[创建LocalDate] --> B[now/of/parse]  
    B --> C[加减日期]  
    C --> D[比较日期]  
    D --> E[格式化输出]  
</mermaid>  

== 总结 ==  
`LocalDate` 是处理纯日期的理想选择，提供了丰富的操作方法，适合从简单日期计算到复杂业务逻辑的场景。通过结合 `DateTimeFormatter` 和 `ChronoUnit`，可以高效解决大多数日期问题。  

{{Java日期时间API}}

[[Category:编程语言]]
[[Category:Java]]
[[Category:Java日期时间api]]