Java 中日期时间 API 怎么替代传统的 Date 与 Calendar 类

秋辰小哥_2515

秋辰小哥_2515

2026-09-27

211人浏览

原创

java 8 的 java.time api 全面替代 date 和 calendar,具备清晰语义、不可变性、线程安全等优势;用 localdate/localtime/lambdadatetime 替代 date 的混用场景,以 zoneddatetime/offsetdatetime 处理时区,用 period/duration 实现语义化时间计算,并谨慎桥接旧 api。

java 中日期时间 api 怎么替代传统的 date 与 calendar 类

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 明确区分:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载
  • 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 提供语义化类型:

  • 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,仅保留兼容性,不应在新代码中使用。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9257

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6422

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5732

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1024

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

848

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1216

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2429

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19791

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1095

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习