0

0

Java常用时间操作类库与Instant、Duration

P粉602998670

P粉602998670

发布时间:2026-01-05 18:25:02

|

234人浏览过

|

来源于php中文网

原创

instant 是基于 utc 的不可变时间点,需用 toepochmilli() 转毫秒数;duration 仅支持 instant 运算;instant.parse() 仅接受 iso-8601 带时区格式;跨系统传时间优先用 instant,存库前须匹配字段类型。

java常用时间操作类库与instant、duration

Java里用 Instant 表示时间点,不是“当前时间字符串”

很多人一看到 Instant.now() 就以为能直接当“时间戳字符串”用,结果打印出来是 2024-05-12T08:23:45.123Z 这种格式,和数据库或前端要的 1715502225123(毫秒级 long)不一致。
关键在于:Instant 是一个不可变的、基于 UTC 的时间点,它本身不带时区偏移,也不提供格式化能力——它只负责精确到纳秒的时间定位。
需要转成毫秒数就用 instant.toEpochMilli();要转成秒级就用 instant.getEpochSecond();反过来从毫秒构造就用 Instant.ofEpochMilli(1715502225123L)

Duration 只算两个 Instant 之间的差,不能加到 LocalDateTime

Duration 是纯时间段(比如“3小时20分钟”),它只支持和 Instant 或另一个 Duration 运算。常见错误是想对 LocalDateTimeDuration

LocalDateTime now = LocalDateTime.now();
LocalDateTime later = now.plus(Duration.ofHours(3)); // 编译失败!

因为 LocalDateTime 没有时区信息,无法确定“3小时后”对应哪个绝对时刻;而 Instant 可以:
Instant now = Instant.now();
Instant later = now.plus(Duration.ofHours(3)); // ✅ 正确

如果真要操作本地时间,得先转成带时区的类型,比如 ZonedDateTime
ZonedDateTime zdt = LocalDateTime.now().atZone(ZoneId.systemDefault());
ZonedDateTime later = zdt.plus(Duration.ofHours(3));

别再用 DateSimpleDateFormat,但要注意 Instant.parse() 的格式限制

Instant.parse() 只接受 ISO-8601 格式,且必须带时区标识(Z+08:00)。传入 "2024-05-12 08:23:45""2024-05-12T08:23:45" 都会抛 DateTimeParseException
常见适配方式:

Deja Videos
Deja Videos

AI视频内容编辑工具

下载
  • 如果是无时区的本地时间字符串,先用 LocalDateTime.parse(),再结合时区转成 Instant
    LocalDateTime ldt = LocalDateTime.parse("2024-05-12T08:23:45");
    Instant instant = ldt.atZone(ZoneId.of("Asia/Shanghai")).toInstant();
  • 如果原始字符串带空格分隔,用 DateTimeFormatter 显式指定:
    DateTimeFormatter f = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    LocalDateTime ldt = LocalDateTime.parse("2024-05-12 08:23:45", f);
记住:Instant 不处理“年月日”逻辑,闰秒、夏令时、月份天数这些都交给 ZonedDateTimeLocalDateTime 去管。

跨系统传时间优先用 Instant,存数据库前确认字段类型

微服务之间传递时间点,统一用 Instant + JSON 序列化(如 Jackson 默认支持),避免各服务用不同时区解析出错。
但写入数据库时容易踩坑:

  • MySQL 的 DATETIME 类型不带时区,JDBC 驱动默认按 JVM 时区解释,可能把 Instant 错转成本地时间;建议显式用 PreparedStatement.setObject(idx, instant, JDBCType.TIMESTAMP_WITH_TIMEZONE)(需 MySQL 8.0+ 和 Connector/J 8.0+)
  • PostgreSQL 的 TIMESTAMP WITH TIME ZONE 字段能正确接收 Instant,但 Hibernate 6 默认映射为 java.time.Instant,5.x 则需手动配置 @Column(columnDefinition = "TIMESTAMP WITH TIME ZONE")
  • 如果数据库字段是 BIGINT 存毫秒值,那就老老实实用 instant.toEpochMilli() 转,别碰字符串中间层
真正麻烦的从来不是怎么表示时间,而是“谁在什么时候、用什么规则解释这个时间”。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

684

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

472

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

287

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

519

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

265

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

392

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

542

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

665

2023.08.14

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

33

2026.03.04

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2.4万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 844人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号