编辑“︁Java ZonedDateTime”︁

{{DISPLAYTITLE:Java ZonedDateTime}}  
'''ZonedDateTime''' 是 Java 日期时间 API（`java.time` 包）中的一个核心类，用于表示带有时区信息的日期和时间。它是 `LocalDateTime` 的扩展，结合了时区（`ZoneId`）和偏移量（`ZoneOffset`），能够精确处理全球不同地区的日期和时间计算。  

== 概述 ==  
`ZonedDateTime` 存储了以下信息：  
* 日期和时间（年、月、日、时、分、秒、纳秒）  
* 时区（如 `America/New_York`）  
* 与 UTC 的偏移量（如 `-05:00`）  

它适用于需要明确时区场景的应用程序，例如跨时区的会议调度、航班时刻表或日志记录。  

=== 与相关类的区别 ===  
* '''`LocalDateTime`'''：仅包含日期和时间，无时区信息。  
* '''`OffsetDateTime`'''：包含日期时间和与 UTC 的偏移量，但不关联具体时区规则（如夏令时）。  
* '''`Instant`'''：表示时间线上的瞬时点，与时区无关（基于 UTC）。  

== 创建 ZonedDateTime ==  
=== 当前时间 ===  
使用 `now()` 方法获取当前时区的日期时间：  
<syntaxhighlight lang="java">  
ZonedDateTime now = ZonedDateTime.now();  
System.out.println(now); // 输出示例: 2023-10-05T14:30:15.123456789+08:00[Asia/Shanghai]  
</syntaxhighlight>  

=== 指定时区 ===  
通过 `ZoneId` 指定时区：  
<syntaxhighlight lang="java">  
ZonedDateTime tokyoTime = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));  
System.out.println(tokyoTime); // 输出示例: 2023-10-05T15:30:15.123456789+09:00[Asia/Tokyo]  
</syntaxhighlight>  

=== 从 LocalDateTime 转换 ===  
将 `LocalDateTime` 关联时区：  
<syntaxhighlight lang="java">  
LocalDateTime localDateTime = LocalDateTime.of(2023, 10, 5, 10, 0);  
ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("Europe/Paris"));  
System.out.println(zonedDateTime); // 输出: 2023-10-05T10:00+02:00[Europe/Paris]  
</syntaxhighlight>  

== 时区转换 ==  
使用 `withZoneSameInstant()` 转换时区（时间点不变）：  
<syntaxhighlight lang="java">  
ZonedDateTime newYorkTime = tokyoTime.withZoneSameInstant(ZoneId.of("America/New_York"));  
System.out.println(newYorkTime); // 输出示例: 2023-10-05T02:30:15.123456789-04:00[America/New_York]  
</syntaxhighlight>  

=== 时区偏移图 ===  
<mermaid>  
graph LR  
    UTC -->|+09:00| Tokyo  
    UTC -->|+08:00| Shanghai  
    UTC -->|-04:00| NewYork  
</mermaid>  

== 操作与计算 ==  
=== 加减时间 ===  
<syntaxhighlight lang="java">  
ZonedDateTime nextWeek = now.plusWeeks(1);  
ZonedDateTime twoHoursEarlier = now.minusHours(2);  
</syntaxhighlight>  

=== 比较时间 ===  
<syntaxhighlight lang="java">  
boolean isBefore = now.isBefore(newYorkTime);  
boolean isAfter = now.isAfter(tokyoTime);  
</syntaxhighlight>  

== 实际案例 ==  
=== 跨时区会议调度 ===  
假设旧金山（UTC-7）的用户需要安排与伦敦（UTC+1）的会议：  
<syntaxhighlight lang="java">  
ZonedDateTime sfMeetingTime = ZonedDateTime.of(2023, 12, 15, 9, 0, 0, 0, ZoneId.of("America/Los_Angeles"));  
ZonedDateTime londonMeetingTime = sfMeetingTime.withZoneSameInstant(ZoneId.of("Europe/London"));  
System.out.println("伦敦时间: " + londonMeetingTime); // 输出: 2023-12-15T17:00+00:00[Europe/London]  
</syntaxhighlight>  

=== 处理夏令时 ===  
`ZonedDateTime` 自动处理夏令时调整：  
<syntaxhighlight lang="java">  
ZonedDateTime beforeDst = ZonedDateTime.of(2023, 3, 12, 1, 30, 0, 0, ZoneId.of("America/New_York"));  
ZonedDateTime afterDst = beforeDst.plusHours(1);  
System.out.println(afterDst); // 输出: 2023-03-12T03:30-04:00[America/New_York]（跳过 2:30）  
</syntaxhighlight>  

== 格式化与解析 ==  
使用 `DateTimeFormatter`：  
<syntaxhighlight lang="java">  
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");  
String formatted = now.format(formatter);  
System.out.println(formatted); // 输出示例: 2023-10-05 14:30:15 CST  

ZonedDateTime parsed = ZonedDateTime.parse("2023-10-05 14:30:15 CST", formatter);  
</syntaxhighlight>  

== 总结 ==  
* `ZonedDateTime` 是处理时区敏感任务的理想选择。  
* 始终优先使用时区 ID（如 `Asia/Shanghai`）而非固定偏移量。  
* 转换时区时使用 `withZoneSameInstant()` 保持时间点一致。  

{{Java Date and Time API}}

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