登录
首页 >  文章 >  java教程

Java时间戳转日期,SimpleDateFormat使用详解

时间:2026-03-23 19:52:36 138浏览 收藏

本文深入剖析了Java中时间戳与日期转换的常见误区与最佳实践,明确指出SimpleDateFormat根本不适用于直接解析时间戳(它只处理字符串与Date的双向转换),并详解了因误用parse()、时区未显式设置及线程不安全导致的ParseException、8小时偏差和并发异常等典型问题;同时系统给出了三种可靠解决方案:每次使用新建实例、ThreadLocal封装,以及强烈推荐的Java 8+迁移路径——采用线程安全、设计合理、时区清晰的java.time API(如Instant、ZonedDateTime和DateTimeFormatter),帮助开发者彻底告别隐患,写出更健壮、可维护的时间处理代码。

Java中如何把时间戳转换成日期格式_SimpleDateFormat的使用指南

SimpleDateFormat.parse() 报 ParseException 怎么办

时间戳是长整型(long),而 SimpleDateFormat.parse() 只接受字符串,直接传数字会编译报错;更常见的是误把毫秒时间戳当秒传入,再用 parse() 去“解析”,结果抛出 ParseException——它根本不是干这个的。

正确做法是先用 new Date(long) 构造日期对象,再交给 SimpleDateFormat.format() 转成字符串。别碰 parse(),除非你真在处理形如 "2024-03-15 14:23:00" 的字符串输入。

  • SimpleDateFormat 不处理时间戳,只负责字符串 ↔ Date 的双向转换
  • 时间戳 → 字符串:先 new Date(timestamp),再 format()
  • 字符串 → 时间戳:先 parse()Date,再调 getTime()

时区错乱、比实际时间快8小时的原因

默认情况下,SimpleDateFormat 使用 JVM 启动时的本地时区(比如东八区),但如果你的原始时间戳来自 UTC 服务(如数据库、API 返回的 Unix 时间戳),没显式设时区就会差出整块偏移量。

解决方式不是靠“猜”或改系统时区,而是明确指定:

  • simpleDateFormat.setTimeZone(TimeZone.getTimeZone("UTC")) 统一按 UTC 解析/格式化
  • 若要输出为北京时间,用 "GMT+8""Asia/Shanghai"(后者更稳妥,能自动处理夏令时)
  • 避免依赖 SimpleDateFormat 的默认行为,每次创建后立刻设时区

SimpleDateFormat 是线程不安全的,多线程下怎么用

多个线程共用同一个 SimpleDateFormat 实例,会出现格式错乱、解析失败甚至返回 null——这不是偶发 bug,是设计如此。内部缓存了 Calendar 和中间状态,没法并发。

有三种实际可用方案,按推荐顺序:

  • 每次用都 new 一个:new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")(小流量、低频调用够用)
  • ThreadLocal 包一层,保证线程独占实例
  • 升级到 Java 8+,改用 DateTimeFormatter + Instant / ZonedDateTime(真正不可变、线程安全)

别试图加锁包装 SimpleDateFormat,性能差且容易漏锁。

Java 8 以后还该用 SimpleDateFormat 吗

不该。从 Java 8 开始,SimpleDateFormat 就被标记为 legacy,官方明确建议迁移到 java.time 包。它的核心问题不只是线程安全,还有设计反直觉(比如月份从 0 开始)、时区支持弱、无法处理纳秒精度等。

对应迁移很简单:

  • 时间戳 → 字符串:Instant.ofEpochMilli(timestamp).atZone(ZoneId.of("Asia/Shanghai")).format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"))
  • 字符串 → 时间戳:LocalDateTime.parse(str, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")).atZone(ZoneId.systemDefault()).toInstant().toEpochMilli()
  • DateTimeFormatter 是 immutable、线程安全的,可复用全局实例

老项目里如果还有大量 SimpleDateFormat,优先在新逻辑中用 java.time,旧代码不必强改,但别再新增。

理论要掌握,实操不能落!以上关于《Java时间戳转日期,SimpleDateFormat使用详解》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>