Java 8 的 java.time API 全面替代 Date 和 Calendar,具备清晰语义、不可变性、线程安全等优势;用 LocalDate/LocalTime/LambdaDateTime 替代 Date 的混用场景,以 ZonedDateTime/OffsetDateTime 处理时区,用 Period/Duration 实现语义化时间计算,并谨慎桥接旧 API。

Java 8 引入的 java.time API 是对传统 Date 和 Calendar 的全面替代,它更清晰、不可变、线程安全,且设计符合实际业务语义。
用 LocalDate / LocalTime / LocalDateTime 替代 Date 的“日期+时间”用途
Date 常被误用为纯日期或纯时间,但它实际表示的是自 1970-01-01 00:00:00 UTC 起的毫秒数,且包含时区隐含逻辑(Date.toString() 会按本地时区格式化,易引发误解)。java.time 拆分了职责:
-
LocalDate:只关心年月日(如生日、合同生效日) -
LocalTime:只关心时分秒纳秒(如营业开始时间) -
LocalDateTime:无时区的日期+时间(如系统日志时间戳,不涉及跨时区计算)
示例:
LocalDateTime now = LocalDateTime.now();
LocalDate today = LocalDate.now();
LocalTime lunch = LocalTime.of(12, 0);
用 ZonedDateTime / OffsetDateTime 处理带时区的时间
Calendar 的时区操作繁琐且易错(如 setTimeZone() 不影响已有字段),Date 本身不含时区信息却依赖系统默认时区格式化。现代 API 明确区分:
-
OffsetDateTime:带固定偏移(如 "+08:00"),适合记录服务器日志、数据库存储(JDBC 4.2+ 支持) -
ZonedDateTime:带时区规则(如 "Asia/Shanghai"),能自动处理夏令时、历史规则变更
示例:
OffsetDateTime utcNow = OffsetDateTime.now(ZoneOffset.UTC);
ZonedDateTime shanghaiTime = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
用 Period / Duration 替代手动计算日期差
过去用 Calendar 加减月份/天数容易出错(如 1 月 31 日加 1 个月变成 3 月 3 日而非 2 月 28 日),计算两个时间间隔需手动转换毫秒再除法。新 API 提供语义化类型:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记(深入)”;
-
Duration:基于时间量(秒、纳秒),用于LocalTime或Instant之间的差 -
Period:基于日期单位(年、月、日),用于LocalDate或LocalDateTime之间的差
示例:
Period oneMonth = Period.ofMonths(1);
LocalDate nextMonth = LocalDate.now().plus(oneMonth); // 自动处理月末(如 1 月 31 日 → 2 月 28 日)
Duration halfHour = Duration.ofMinutes(30);
LocalTime end = LocalTime.now().plus(halfHour);
与旧 API 互操作要谨慎
遗留系统仍可能返回 Date 或 Calendar,可借助工具方法桥接,但应尽快收敛到新类型:
-
Date.toInstant()→Instant.atZone(ZoneId.systemDefault())→ZonedDateTime -
Calendar.toInstant()直接获取Instant -
LocalDateTime.atZone(ZoneId).toInstant() →Date.from(instant)
注意:Date 和 Calendar 的构造和 get/set 方法已标记为 @Deprecated,仅保留兼容性,不应在新代码中使用。

















