Java 开发实战中日期时间 API 怎么替代过时的 Calendar-java教程-PHP中文网

Java 8 的 java.time API 是 Calendar 和 Date 的现代化替代方案，核心包括 LocalDate/LocalTime/LocalDateTime 处理无时区日期时间、ZonedDateTime/OffsetDateTime 处理时区、Instant 表示绝对时间戳、DateTimeFormatter 替代线程不安全的 SimpleDateFormat。

java 开发实战中日期时间 api 怎么替代过时的 calendar

Java 8 引入的 java.time API（JSR-310）是 Calendar 和 Date 的现代化替代方案，设计更清晰、线程安全、语义明确。直接用它替换过时的 Calendar，核心在于理解其类型分工和不可变性原则。

用 LocalDate / LocalTime / LocalDateTime 替代“无时区纯日期/时间”操作

Calendar 常被误用于仅处理日期（如“2024-05-20”）或时间（如“14:30”），但它实际绑定时区且状态可变，易出错。

替换 get(Calendar.YEAR) / set(Calendar.MONTH) 等：用 LocalDate —— 它只关心年月日，不涉及时区和毫秒精度。
例：获取今天、加3天、格式化：
```
LocalDate today = LocalDate.now();<br>LocalDate after3 = today.plusDays(3);<br>String s = today.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));
```
只处理时间（如营业时段）：用 LocalTime，支持 plusHours()、isBefore() 等，比 Calendar 的 HOUR_OF_DAY 操作直观得多。
同时需要日期+时间（无时区上下文，如数据库 DATETIME 字段）：用 LocalDateTime。注意：它不是“当前时刻”，而是“本地系统时钟下的日期时间快照”，不包含时区信息。

用 ZonedDateTime / OffsetDateTime 处理真实世界的时间（含时区）

Calendar 的时区处理依赖 setTimeZone()，但容易遗漏或覆盖；而 java.time 把时区作为类型的一部分，强制显式表达。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

要表示“北京时间2024-05-20 10:00”这个带时区的完整时刻：用 ZonedDateTime.of(LocalDateTime, ZoneId) 或直接 ZonedDateTime.now(ZoneId.of("Asia/Shanghai"))。
与服务器通信常用带偏移量的时间（如 ISO 8601 格式 "2024-05-20T10:00:00+08:00"）：用 OffsetDateTime，比 Calendar 解析 + set() 组合更可靠。

跨时区转换（如用户在纽约下单，需转为 UTC 存储）：

ZonedDateTime nyTime = ZonedDateTime.now(ZoneId.of("America/New_York"));<br>ZonedDateTime utcTime = nyTime.withZoneSameInstant(ZoneId.of("UTC"));

用 Instant 替代 System.currentTimeMillis() 和 “绝对时间戳”场景

Calendar.getTime().getTime() 或 new Date().getTime() 返回 long 毫秒值，本质是 UTC 时间轴上的一个点。这正是 Instant 的定位 —— 不可变、线程安全、零时区。

记录日志时间、计算耗时、数据库 TIMESTAMP WITH TIME ZONE 字段：优先用 Instant.now()。
与旧代码交互时转换：
Instant.from(calendar.toInstant())（推荐）
Instant.ofEpochMilli(date.getTime())
反向也简单：Date.from(instant)、calendar.setTime(Date.from(instant))。

用 DateTimeFormatter 替代 SimpleDateFormat（线程安全！）

SimpleDateFormat 非线程安全，常因共享实例引发诡异 bug；DateTimeFormatter 是不可变且线程安全的。

预定义格式直接用静态常量：如 DateTimeFormatter.ISO_LOCAL_DATE、DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")。
避免每次 new Formatter：把它声明为 static final 字段复用。
解析时严格校验：默认严格模式，遇到非法输入（如 2024-02-30）直接抛 DateTimeParseException，比 Calendar 的静默错误更健壮。