1. 项目概述时间戳Java开发者绕不开的“小”问题在Java开发中处理时间戳和时间字符串的互相转换几乎是每个项目都会遇到的“标配”操作。无论是记录日志、缓存过期、订单生成还是与前端、数据库进行时间数据交互都离不开它。表面上看这只是一个简单的new Date()或者SimpleDateFormat的事情但实际开发中毫秒与秒的混淆、时区的坑、线程安全问题、新老API的选择每一个细节都可能让你在深夜调试时抓狂。特别是当需求从“显示个时间”变成“精确到毫秒的时间戳比对”或“跨时区时间同步”时很多临时拼凑的代码就会暴露出问题。今天我们就来彻底拆解Java中时间戳与时间的转换不仅告诉你“怎么做”更要说清楚“为什么这么做”以及如何避开那些常见的“坑”。2. 核心概念厘清时间戳、Date与新时代的java.time在动手写代码之前我们必须先统一认识几个核心概念。很多转换时的混乱都源于概念理解上的偏差。2.1 什么是时间戳在计算机科学中时间戳通常指一个特定的时间点相对于一个公认的“纪元”所经过的秒数或毫秒数。在Java的语境里最常用的纪元是“Unix纪元”或“Unix时间戳”即1970年1月1日00:00:00 UTC。这里有两个关键点单位可以是秒second或毫秒millisecond。1秒 1000毫秒。这是所有混淆的根源之一。一个以秒为单位的时间戳其数值上是以毫秒为单位时间戳的1/1000。时区Unix时间戳的定义是基于**UTC协调世界时**的。这意味着同一个时间戳在任何时区都代表同一个绝对的物理时刻。例如时间戳1715612400000在伦敦、东京、纽约指向的都是同一个UTC时间。我们将其转换为本地时间字符串时才会因时区不同而显示不同的“钟表时间”。2.2 Java中的时间表示从Date到InstantJava提供了多种表示时间的方式其演进也反映了编程理念的进步。java.util.Date旧时代这个类实际上并不“纯真”。虽然名字叫Date但它内部存储的是一个自Unix纪元以来的毫秒数一个long类型的值。它的toString()方法会默认使用JVM的默认时区进行格式化输出这常常误导开发者以为它包含了时区信息其实它没有。Date对象本身是与时区无关的它只代表那个毫秒数对应的UTC时刻。由于其API设计不佳如年份从1900开始算月份从0开始、非线程安全等问题在新的代码中已不推荐使用。java.time包新时代Java 8这是Java 8引入的全新日期时间API位于java.time包下设计清晰、线程安全、功能强大。Instant 代表时间线上的一个瞬时点可以精确到纳秒。它通常用于表示时间戳。你可以把它理解为一个更现代、更精确的、与时区无关的时间点类似于Date但更好用。LocalDateTime 不包含时区信息的日期时间例如“2024-05-13T10:30:00”。它就是你看到的本地挂钟时间但不知道这个挂钟是在哪个时区。ZonedDateTime 包含时区的完整的日期时间例如“2024-05-13T10:30:0008:00[Asia/Shanghai]”。它能明确表达一个确定的时刻。LocalDate、LocalTime 仅表示日期或时间。核心关系Instant- (时区) -ZonedDateTime- (剥离时区) -LocalDateTime。Instant是绝对的基准加上时区信息得到ZonedDateTime如果只关心本地显示可以转换为LocalDateTime。3. 毫秒级时间戳的转换实战毫秒级时间戳是最常见的形式比如System.currentTimeMillis()返回的就是它。我们分别用新旧API来实现转换。3.1 使用旧API (java.util.Date和SimpleDateFormat)虽然不推荐新项目使用但维护老代码时你必须懂。场景一时间戳毫秒 - 格式化时间字符串import java.text.SimpleDateFormat; import java.util.Date; import java.util.TimeZone; public class TimestampConverterOld { public static void main(String[] args) { // 获取当前毫秒时间戳 long currentTimestampMs System.currentTimeMillis(); System.out.println(当前毫秒时间戳: currentTimestampMs); // 1. 创建Date对象 Date date new Date(currentTimestampMs); // 2. 创建格式化器并定义模式 SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd HH:mm:ss.SSS); // 关键步骤显式设置时区避免依赖默认时区导致意外结果 sdf.setTimeZone(TimeZone.getTimeZone(Asia/Shanghai)); // 3. 格式化 String formattedDate sdf.format(date); System.out.println(转换后的时间字符串(北京时区): formattedDate); } }注意SimpleDateFormat是非线程安全的这意味着你不能将它声明为static变量在多线程环境下共享使用否则会导致格式错乱或异常。正确的做法是每次使用时创建新实例或者使用ThreadLocal进行包装。这是使用旧API时最大的坑之一。场景二时间字符串 - 时间戳毫秒import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; public class StringToTimestampOld { public static void main(String[] args) { String timeStr 2024-05-13 18:30:45.123; SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd HH:mm:ss.SSS); // 同样必须明确时区这里假设字符串表示的是北京时间 sdf.setTimeZone(TimeZone.getTimeZone(Asia/Shanghai)); try { Date date sdf.parse(timeStr); long timestampMs date.getTime(); // 获取毫秒时间戳 System.out.println(时间字符串 \ timeStr \ 对应的毫秒时间戳: timestampMs); } catch (ParseException e) { System.out.println(时间字符串解析失败: e.getMessage()); // 格式不匹配或字符串非法时会抛出此异常 } } }3.2 使用新API (java.time)这是现代Java开发的推荐方式API清晰且强大。场景一时间戳毫秒 - 格式化时间字符串import java.time.Instant; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class TimestampConverterNew { public static void main(String[] args) { long currentTimestampMs System.currentTimeMillis(); // 1. 将毫秒时间戳转换为 Instant Instant instant Instant.ofEpochMilli(currentTimestampMs); System.out.println(Instant 表示: instant); // 输出UTC时间如 2024-05-13T10:30:45.123Z // 2. 为 Instant 添加时区信息得到 ZonedDateTime ZoneId shanghaiZone ZoneId.of(Asia/Shanghai); ZonedDateTime zonedDateTime instant.atZone(shanghaiZone); System.out.println(上海时区时间: zonedDateTime); // 3. 定义格式化模式并格式化 DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss.SSS); String formattedDate zonedDateTime.format(formatter); System.out.println(格式化后的字符串: formattedDate); // 如果你想得到不包含时区信息的本地日期时间 // LocalDateTime localDateTime zonedDateTime.toLocalDateTime(); // String localFormatted localDateTime.format(formatter); } }场景二时间字符串 - 时间戳毫秒import java.time.LocalDateTime; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class StringToTimestampNew { public static void main(String[] args) { String timeStr 2024-05-13 18:30:45.123; // 定义格式化器模式必须与字符串严格匹配 DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss.SSS); // 1. 将字符串解析为 LocalDateTime (因为它不包含时区信息) LocalDateTime localDateTime LocalDateTime.parse(timeStr, formatter); System.out.println(解析出的 LocalDateTime: localDateTime); // 2. 为 LocalDateTime 指定一个时区将其转换为一个确定的时刻 (ZonedDateTime) ZoneId shanghaiZone ZoneId.of(Asia/Shanghai); ZonedDateTime zonedDateTime localDateTime.atZone(shanghaiZone); // 3. 将 ZonedDateTime 转换为 Instant再获取毫秒时间戳 Instant instant zonedDateTime.toInstant(); long timestampMs instant.toEpochMilli(); System.out.println(对应的毫秒时间戳: timestampMs); } }实操心得使用java.time时时刻思考你处理的对象是“时刻”Instant,ZonedDateTime还是“本地挂钟显示”LocalDateTime。从字符串解析时如果字符串里没有时区信息如08:00你必须通过atZone()或atOffset()为其赋予一个时区才能得到唯一确定的Instant和时间戳。否则LocalDateTime本身是无法转换为时间戳的因为它缺少了“在哪个时区”这个关键信息。4. 秒级时间戳的转换与常见混淆处理秒级时间戳常见于某些API接口、数据库字段如MySQL的UNIX_TIMESTAMP()函数或一些较老的系统中。处理它的核心就一点注意单位换算。4.1 秒与毫秒的互相转换原理非常简单秒 - 毫秒:milliseconds seconds * 1000毫秒 - 秒:seconds milliseconds / 1000(通常用整数除法或转换为long)转换示例public class SecondTimestampConversion { public static void main(String[] args) { // 假设有一个来自某接口的秒级时间戳 long timestampSec 1715612445L; // 秒级转毫秒级 long timestampMs timestampSec * 1000L; System.out.println(秒级时间戳 timestampSec 对应的毫秒级为: timestampMs); // 使用毫秒级时间戳进行转换沿用上一节的代码 Instant instantFromSec Instant.ofEpochSecond(timestampSec); // 注意这里用了 ofEpochSecond // 等价于 Instant.ofEpochMilli(timestampSec * 1000L); System.out.println(直接通过秒构建的Instant: instantFromSec); // 毫秒级转秒级 long currentMs System.currentTimeMillis(); long currentSec currentMs / 1000L; // 取整丢弃毫秒部分 System.out.println(当前毫秒时间戳 currentMs 对应的秒级(取整)为: currentSec); // 如果需要浮点数表示的秒 double currentSecDouble currentMs / 1000.0; System.out.println(当前毫秒时间戳对应的秒级(浮点)为: currentSecDouble); } }特别提醒Instant类提供了ofEpochMilli(long)和ofEpochSecond(long)两个方法专门用于从毫秒和秒创建实例。务必根据你手中时间戳的单位选择正确的方法避免因乘以或除以1000的失误导致时间错误。4.2 如何判断一个时间戳是秒还是毫秒这是一个非常实际的调试问题。当你拿到一个陌生的long型时间戳如何快速判断它的单位数值范围估算法这是最常用的方法。记住几个关键锚点当前时间2024年的毫秒时间戳大约是17,1xxxx,xxxxxx170亿左右。当前时间的秒时间戳大约是1,7xxxx,xx17亿左右。如果你的时间戳是10位数1,600,000,000 这个量级它很可能是秒。如果你的时间戳是13位数1,600,000,000,000 这个量级它很可能是毫秒。在线工具或代码验证将时间戳分别以秒和毫秒为单位用在线转换工具或你自己的代码尝试转换成一个可读日期。看哪个转换出来的日期是合理的比如在1970年之后不是未来几万年。例如时间戳1715612445当作秒转换成日期是2024-05-13(合理)。当作毫秒转换成日期是1970-01-20(1970年显然不对)。查阅文档或沟通最可靠的方式永远是查阅数据来源的接口文档或与提供数据的同事确认。5. 时区问题隐藏在转换背后的“时间刺客”如果不显式处理时区你的时间转换可能会在跨时区部署或与外部系统交互时产生令人费解的Bug。核心原则在涉及“时刻”的计算和存储时使用UTC仅在最终显示给用户时转换为本地时间。5.1 时区问题复现import java.time.Instant; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class TimeZonePitfall { public static void main(String[] args) { long timestampMs 1715612400000L; // 一个确定的UTC时刻 Instant instant Instant.ofEpochMilli(timestampMs); System.out.println(UTC时刻: instant); // 在不同时区下这个时刻的“本地时钟显示”是不同的 ZonedDateTime zdtShanghai instant.atZone(ZoneId.of(Asia/Shanghai)); ZonedDateTime zdtNewYork instant.atZone(ZoneId.of(America/New_York)); DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); System.out.println(在上海显示: zdtShanghai.format(formatter)); System.out.println(在纽约显示: zdtNewYork.format(formatter)); // 输出 // UTC时刻: 2024-05-13T10:00:00Z // 在上海显示: 2024-05-13 18:00:00 (UTC8) // 在纽约显示: 2024-05-13 06:00:00 (UTC-4, 夏令时) } }5.2 最佳实践与避坑指南存储与传输用UTC在数据库存储、API接口传输、系统间通信时强烈建议使用UTC时间Instant或毫秒时间戳。这保证了时间的唯一性和无歧义性。例如你的数据库timestamp字段应该设置为UTC时区。显式指定时区在任何格式化(format)或解析(parse)操作中永远不要依赖JVM的默认时区TimeZone.getDefault()。通过setTimeZone或withZone方法显式指定。例如// 旧API sdf.setTimeZone(TimeZone.getTimeZone(UTC)); // 新API DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss) .withZone(ZoneId.of(Asia/Shanghai));使用正确的时区标识不要使用缩写如CST它可同时表示中国标准时间、美国中部时间等而应使用地区/城市格式如Asia/Shanghai,America/New_York这是明确无误的。处理用户输入当从用户界面接收时间字符串时必须知道这个字符串是用户所在时区的时间。前端通常应传递一个带时区偏移的ISO8601字符串如2024-05-13T18:00:0008:00或者同时传递时间字符串和时区信息。后端根据这个时区信息将其正确转换为UTC时间进行存储。6. 实战中的高频场景与代码封装理解了原理我们可以将常用操作封装成工具类提升开发效率。6.1 封装一个线程安全的时间工具类import java.time.*; import java.time.format.DateTimeFormatter; import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.ConcurrentMap; public class DateTimeUtils { // 使用ConcurrentHashMap缓存Formatter避免重复创建DateTimeFormatter本身是线程安全的 private static final ConcurrentMapString, DateTimeFormatter FORMATTER_CACHE new ConcurrentHashMap(); private static final ZoneId DEFAULT_ZONE ZoneId.of(Asia/Shanghai); private static final String DEFAULT_PATTERN yyyy-MM-dd HH:mm:ss; /** * 获取缓存的或新建的DateTimeFormatter */ private static DateTimeFormatter getFormatter(String pattern) { return FORMATTER_CACHE.computeIfAbsent(pattern, DateTimeFormatter::ofPattern); } /** * 毫秒时间戳 - 默认格式的本地时间字符串 (默认北京时区) */ public static String format(long timestampMs) { return format(timestampMs, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 毫秒时间戳 - 指定格式、指定时区的时间字符串 */ public static String format(long timestampMs, String pattern, ZoneId zoneId) { Instant instant Instant.ofEpochMilli(timestampMs); ZonedDateTime zdt instant.atZone(zoneId); DateTimeFormatter formatter getFormatter(pattern); return zdt.format(formatter); } /** * 秒时间戳 - 默认格式的本地时间字符串 */ public static String formatFromSeconds(long timestampSec) { return format(timestampSec * 1000L, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 时间字符串 (默认北京时区) - 毫秒时间戳 */ public static long parseToMillis(String timeStr) throws DateTimeException { return parseToMillis(timeStr, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 时间字符串 (指定格式、时区) - 毫秒时间戳 */ public static long parseToMillis(String timeStr, String pattern, ZoneId zoneId) throws DateTimeException { DateTimeFormatter formatter getFormatter(pattern); LocalDateTime ldt LocalDateTime.parse(timeStr, formatter); ZonedDateTime zdt ldt.atZone(zoneId); return zdt.toInstant().toEpochMilli(); } /** * 获取当前时间的秒级时间戳 */ public static long currentTimeSeconds() { return Instant.now().getEpochSecond(); // 更清晰的方式 } /** * 获取当前时间的毫秒级时间戳 */ public static long currentTimeMillis() { return System.currentTimeMillis(); // 或者 Instant.now().toEpochMilli() } }6.2 常见场景示例public class CommonScenarios { public static void main(String[] args) { // 场景1生成订单号时间戳部分 String orderId ORD System.currentTimeMillis(); // 简单做法可能有并发重复风险 // 更佳做法结合机器ID、序列号等 // 场景2计算代码执行耗时 long start System.nanoTime(); // 纳秒用于精确测量短时间间隔 // ... 执行一些操作 ... long end System.nanoTime(); long durationMs (end - start) / 1_000_000L; // 转换为毫秒 System.out.println(操作耗时: durationMs 毫秒); // 对于更长的耗时直接用毫秒时间戳即可 long startMs System.currentTimeMillis(); // ... 执行一些操作 ... long endMs System.currentTimeMillis(); System.out.println(操作耗时: (endMs - startMs) 毫秒); // 场景3处理前端传递的ISO8601格式时间 String isoTimeStr 2024-05-13T18:30:4508:00; Instant instant Instant.from(DateTimeFormatter.ISO_OFFSET_DATE_TIME.parse(isoTimeStr)); System.out.println(解析ISO时间得到的时间戳: instant.toEpochMilli()); // 场景4与数据库交互 (以MyBatis为例) // 实体类中可以使用 java.time.LocalDateTime 类型字段 // 在MyBatis配置中需要合适的TypeHandler (如 org.apache.ibatis.type.LocalDateTimeTypeHandler) } }7. 性能考量与异常处理7.1 性能考量SimpleDateFormatvsDateTimeFormatterDateTimeFormatter不仅是线程安全的而且在多数情况下性能也优于SimpleDateFormat尤其是在高并发场景下避免了每次创建和销毁对象的开销。缓存Formatter模式字符串的解析是一个相对耗时的操作。如上文工具类所示将创建好的DateTimeFormatter实例缓存起来复用能有效提升性能。System.currentTimeMillis()vsInstant.now()两者获取当前毫秒时间戳的性能差异极小可忽略不计。Instant.now()能提供更高精度纳秒但System.currentTimeMillis()是更传统的写法。在Java 8环境中根据代码风格选择即可。7.2 异常处理时间转换中最常见的异常是解析异常。ParseException(SimpleDateFormat)当输入的字符串与定义的模式不匹配时抛出。务必在调用parse()方法时进行捕获和处理。DateTimeParseException(java.time)功能同上是java.time包中的对应异常。健壮的解析代码示例import java.time.DateTimeException; import java.time.format.DateTimeFormatter; import java.time.format.DateTimeParseException; public class RobustParsing { private static final DateTimeFormatter FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); public static Long safeParse(String timeStr) { if (timeStr null || timeStr.trim().isEmpty()) { return null; // 或根据业务逻辑返回默认值/抛出业务异常 } try { // 这里假设时间字符串是北京时间实际业务中时区应从别处获取 java.time.LocalDateTime ldt java.time.LocalDateTime.parse(timeStr, FORMATTER); return ldt.atZone(java.time.ZoneId.of(Asia/Shanghai)).toInstant().toEpochMilli(); } catch (DateTimeParseException e) { // 记录日志告警或转换为业务友好的异常抛出 System.err.println(无法解析时间字符串: timeStr , 错误: e.getMessage()); return null; // 或抛出自定义的 InvalidParameterException } } }时间戳与时间的转换是Java开发中的基础也是体现代码严谨性的细节。从理解时间戳的绝对性到掌握java.timeAPI的优雅用法再到妥善处理时区和异常每一步都关乎系统的稳定性和数据的准确性。希望这篇内容能帮你把这块知识拧清下次再遇到时间问题可以淡定地说“让我看看你的时间戳和时区。” Java时间戳与时间字符串转换：毫秒/秒处理、时区避坑与java.time实战
1. 项目概述时间戳Java开发者绕不开的“小”问题在Java开发中处理时间戳和时间字符串的互相转换几乎是每个项目都会遇到的“标配”操作。无论是记录日志、缓存过期、订单生成还是与前端、数据库进行时间数据交互都离不开它。表面上看这只是一个简单的new Date()或者SimpleDateFormat的事情但实际开发中毫秒与秒的混淆、时区的坑、线程安全问题、新老API的选择每一个细节都可能让你在深夜调试时抓狂。特别是当需求从“显示个时间”变成“精确到毫秒的时间戳比对”或“跨时区时间同步”时很多临时拼凑的代码就会暴露出问题。今天我们就来彻底拆解Java中时间戳与时间的转换不仅告诉你“怎么做”更要说清楚“为什么这么做”以及如何避开那些常见的“坑”。2. 核心概念厘清时间戳、Date与新时代的java.time在动手写代码之前我们必须先统一认识几个核心概念。很多转换时的混乱都源于概念理解上的偏差。2.1 什么是时间戳在计算机科学中时间戳通常指一个特定的时间点相对于一个公认的“纪元”所经过的秒数或毫秒数。在Java的语境里最常用的纪元是“Unix纪元”或“Unix时间戳”即1970年1月1日00:00:00 UTC。这里有两个关键点单位可以是秒second或毫秒millisecond。1秒 1000毫秒。这是所有混淆的根源之一。一个以秒为单位的时间戳其数值上是以毫秒为单位时间戳的1/1000。时区Unix时间戳的定义是基于**UTC协调世界时**的。这意味着同一个时间戳在任何时区都代表同一个绝对的物理时刻。例如时间戳1715612400000在伦敦、东京、纽约指向的都是同一个UTC时间。我们将其转换为本地时间字符串时才会因时区不同而显示不同的“钟表时间”。2.2 Java中的时间表示从Date到InstantJava提供了多种表示时间的方式其演进也反映了编程理念的进步。java.util.Date旧时代这个类实际上并不“纯真”。虽然名字叫Date但它内部存储的是一个自Unix纪元以来的毫秒数一个long类型的值。它的toString()方法会默认使用JVM的默认时区进行格式化输出这常常误导开发者以为它包含了时区信息其实它没有。Date对象本身是与时区无关的它只代表那个毫秒数对应的UTC时刻。由于其API设计不佳如年份从1900开始算月份从0开始、非线程安全等问题在新的代码中已不推荐使用。java.time包新时代Java 8这是Java 8引入的全新日期时间API位于java.time包下设计清晰、线程安全、功能强大。Instant 代表时间线上的一个瞬时点可以精确到纳秒。它通常用于表示时间戳。你可以把它理解为一个更现代、更精确的、与时区无关的时间点类似于Date但更好用。LocalDateTime 不包含时区信息的日期时间例如“2024-05-13T10:30:00”。它就是你看到的本地挂钟时间但不知道这个挂钟是在哪个时区。ZonedDateTime 包含时区的完整的日期时间例如“2024-05-13T10:30:0008:00[Asia/Shanghai]”。它能明确表达一个确定的时刻。LocalDate、LocalTime 仅表示日期或时间。核心关系Instant- (时区) -ZonedDateTime- (剥离时区) -LocalDateTime。Instant是绝对的基准加上时区信息得到ZonedDateTime如果只关心本地显示可以转换为LocalDateTime。3. 毫秒级时间戳的转换实战毫秒级时间戳是最常见的形式比如System.currentTimeMillis()返回的就是它。我们分别用新旧API来实现转换。3.1 使用旧API (java.util.Date和SimpleDateFormat)虽然不推荐新项目使用但维护老代码时你必须懂。场景一时间戳毫秒 - 格式化时间字符串import java.text.SimpleDateFormat; import java.util.Date; import java.util.TimeZone; public class TimestampConverterOld { public static void main(String[] args) { // 获取当前毫秒时间戳 long currentTimestampMs System.currentTimeMillis(); System.out.println(当前毫秒时间戳: currentTimestampMs); // 1. 创建Date对象 Date date new Date(currentTimestampMs); // 2. 创建格式化器并定义模式 SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd HH:mm:ss.SSS); // 关键步骤显式设置时区避免依赖默认时区导致意外结果 sdf.setTimeZone(TimeZone.getTimeZone(Asia/Shanghai)); // 3. 格式化 String formattedDate sdf.format(date); System.out.println(转换后的时间字符串(北京时区): formattedDate); } }注意SimpleDateFormat是非线程安全的这意味着你不能将它声明为static变量在多线程环境下共享使用否则会导致格式错乱或异常。正确的做法是每次使用时创建新实例或者使用ThreadLocal进行包装。这是使用旧API时最大的坑之一。场景二时间字符串 - 时间戳毫秒import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; public class StringToTimestampOld { public static void main(String[] args) { String timeStr 2024-05-13 18:30:45.123; SimpleDateFormat sdf new SimpleDateFormat(yyyy-MM-dd HH:mm:ss.SSS); // 同样必须明确时区这里假设字符串表示的是北京时间 sdf.setTimeZone(TimeZone.getTimeZone(Asia/Shanghai)); try { Date date sdf.parse(timeStr); long timestampMs date.getTime(); // 获取毫秒时间戳 System.out.println(时间字符串 \ timeStr \ 对应的毫秒时间戳: timestampMs); } catch (ParseException e) { System.out.println(时间字符串解析失败: e.getMessage()); // 格式不匹配或字符串非法时会抛出此异常 } } }3.2 使用新API (java.time)这是现代Java开发的推荐方式API清晰且强大。场景一时间戳毫秒 - 格式化时间字符串import java.time.Instant; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class TimestampConverterNew { public static void main(String[] args) { long currentTimestampMs System.currentTimeMillis(); // 1. 将毫秒时间戳转换为 Instant Instant instant Instant.ofEpochMilli(currentTimestampMs); System.out.println(Instant 表示: instant); // 输出UTC时间如 2024-05-13T10:30:45.123Z // 2. 为 Instant 添加时区信息得到 ZonedDateTime ZoneId shanghaiZone ZoneId.of(Asia/Shanghai); ZonedDateTime zonedDateTime instant.atZone(shanghaiZone); System.out.println(上海时区时间: zonedDateTime); // 3. 定义格式化模式并格式化 DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss.SSS); String formattedDate zonedDateTime.format(formatter); System.out.println(格式化后的字符串: formattedDate); // 如果你想得到不包含时区信息的本地日期时间 // LocalDateTime localDateTime zonedDateTime.toLocalDateTime(); // String localFormatted localDateTime.format(formatter); } }场景二时间字符串 - 时间戳毫秒import java.time.LocalDateTime; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class StringToTimestampNew { public static void main(String[] args) { String timeStr 2024-05-13 18:30:45.123; // 定义格式化器模式必须与字符串严格匹配 DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss.SSS); // 1. 将字符串解析为 LocalDateTime (因为它不包含时区信息) LocalDateTime localDateTime LocalDateTime.parse(timeStr, formatter); System.out.println(解析出的 LocalDateTime: localDateTime); // 2. 为 LocalDateTime 指定一个时区将其转换为一个确定的时刻 (ZonedDateTime) ZoneId shanghaiZone ZoneId.of(Asia/Shanghai); ZonedDateTime zonedDateTime localDateTime.atZone(shanghaiZone); // 3. 将 ZonedDateTime 转换为 Instant再获取毫秒时间戳 Instant instant zonedDateTime.toInstant(); long timestampMs instant.toEpochMilli(); System.out.println(对应的毫秒时间戳: timestampMs); } }实操心得使用java.time时时刻思考你处理的对象是“时刻”Instant,ZonedDateTime还是“本地挂钟显示”LocalDateTime。从字符串解析时如果字符串里没有时区信息如08:00你必须通过atZone()或atOffset()为其赋予一个时区才能得到唯一确定的Instant和时间戳。否则LocalDateTime本身是无法转换为时间戳的因为它缺少了“在哪个时区”这个关键信息。4. 秒级时间戳的转换与常见混淆处理秒级时间戳常见于某些API接口、数据库字段如MySQL的UNIX_TIMESTAMP()函数或一些较老的系统中。处理它的核心就一点注意单位换算。4.1 秒与毫秒的互相转换原理非常简单秒 - 毫秒:milliseconds seconds * 1000毫秒 - 秒:seconds milliseconds / 1000(通常用整数除法或转换为long)转换示例public class SecondTimestampConversion { public static void main(String[] args) { // 假设有一个来自某接口的秒级时间戳 long timestampSec 1715612445L; // 秒级转毫秒级 long timestampMs timestampSec * 1000L; System.out.println(秒级时间戳 timestampSec 对应的毫秒级为: timestampMs); // 使用毫秒级时间戳进行转换沿用上一节的代码 Instant instantFromSec Instant.ofEpochSecond(timestampSec); // 注意这里用了 ofEpochSecond // 等价于 Instant.ofEpochMilli(timestampSec * 1000L); System.out.println(直接通过秒构建的Instant: instantFromSec); // 毫秒级转秒级 long currentMs System.currentTimeMillis(); long currentSec currentMs / 1000L; // 取整丢弃毫秒部分 System.out.println(当前毫秒时间戳 currentMs 对应的秒级(取整)为: currentSec); // 如果需要浮点数表示的秒 double currentSecDouble currentMs / 1000.0; System.out.println(当前毫秒时间戳对应的秒级(浮点)为: currentSecDouble); } }特别提醒Instant类提供了ofEpochMilli(long)和ofEpochSecond(long)两个方法专门用于从毫秒和秒创建实例。务必根据你手中时间戳的单位选择正确的方法避免因乘以或除以1000的失误导致时间错误。4.2 如何判断一个时间戳是秒还是毫秒这是一个非常实际的调试问题。当你拿到一个陌生的long型时间戳如何快速判断它的单位数值范围估算法这是最常用的方法。记住几个关键锚点当前时间2024年的毫秒时间戳大约是17,1xxxx,xxxxxx170亿左右。当前时间的秒时间戳大约是1,7xxxx,xx17亿左右。如果你的时间戳是10位数1,600,000,000 这个量级它很可能是秒。如果你的时间戳是13位数1,600,000,000,000 这个量级它很可能是毫秒。在线工具或代码验证将时间戳分别以秒和毫秒为单位用在线转换工具或你自己的代码尝试转换成一个可读日期。看哪个转换出来的日期是合理的比如在1970年之后不是未来几万年。例如时间戳1715612445当作秒转换成日期是2024-05-13(合理)。当作毫秒转换成日期是1970-01-20(1970年显然不对)。查阅文档或沟通最可靠的方式永远是查阅数据来源的接口文档或与提供数据的同事确认。5. 时区问题隐藏在转换背后的“时间刺客”如果不显式处理时区你的时间转换可能会在跨时区部署或与外部系统交互时产生令人费解的Bug。核心原则在涉及“时刻”的计算和存储时使用UTC仅在最终显示给用户时转换为本地时间。5.1 时区问题复现import java.time.Instant; import java.time.ZoneId; import java.time.ZonedDateTime; import java.time.format.DateTimeFormatter; public class TimeZonePitfall { public static void main(String[] args) { long timestampMs 1715612400000L; // 一个确定的UTC时刻 Instant instant Instant.ofEpochMilli(timestampMs); System.out.println(UTC时刻: instant); // 在不同时区下这个时刻的“本地时钟显示”是不同的 ZonedDateTime zdtShanghai instant.atZone(ZoneId.of(Asia/Shanghai)); ZonedDateTime zdtNewYork instant.atZone(ZoneId.of(America/New_York)); DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); System.out.println(在上海显示: zdtShanghai.format(formatter)); System.out.println(在纽约显示: zdtNewYork.format(formatter)); // 输出 // UTC时刻: 2024-05-13T10:00:00Z // 在上海显示: 2024-05-13 18:00:00 (UTC8) // 在纽约显示: 2024-05-13 06:00:00 (UTC-4, 夏令时) } }5.2 最佳实践与避坑指南存储与传输用UTC在数据库存储、API接口传输、系统间通信时强烈建议使用UTC时间Instant或毫秒时间戳。这保证了时间的唯一性和无歧义性。例如你的数据库timestamp字段应该设置为UTC时区。显式指定时区在任何格式化(format)或解析(parse)操作中永远不要依赖JVM的默认时区TimeZone.getDefault()。通过setTimeZone或withZone方法显式指定。例如// 旧API sdf.setTimeZone(TimeZone.getTimeZone(UTC)); // 新API DateTimeFormatter formatter DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss) .withZone(ZoneId.of(Asia/Shanghai));使用正确的时区标识不要使用缩写如CST它可同时表示中国标准时间、美国中部时间等而应使用地区/城市格式如Asia/Shanghai,America/New_York这是明确无误的。处理用户输入当从用户界面接收时间字符串时必须知道这个字符串是用户所在时区的时间。前端通常应传递一个带时区偏移的ISO8601字符串如2024-05-13T18:00:0008:00或者同时传递时间字符串和时区信息。后端根据这个时区信息将其正确转换为UTC时间进行存储。6. 实战中的高频场景与代码封装理解了原理我们可以将常用操作封装成工具类提升开发效率。6.1 封装一个线程安全的时间工具类import java.time.*; import java.time.format.DateTimeFormatter; import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.ConcurrentMap; public class DateTimeUtils { // 使用ConcurrentHashMap缓存Formatter避免重复创建DateTimeFormatter本身是线程安全的 private static final ConcurrentMapString, DateTimeFormatter FORMATTER_CACHE new ConcurrentHashMap(); private static final ZoneId DEFAULT_ZONE ZoneId.of(Asia/Shanghai); private static final String DEFAULT_PATTERN yyyy-MM-dd HH:mm:ss; /** * 获取缓存的或新建的DateTimeFormatter */ private static DateTimeFormatter getFormatter(String pattern) { return FORMATTER_CACHE.computeIfAbsent(pattern, DateTimeFormatter::ofPattern); } /** * 毫秒时间戳 - 默认格式的本地时间字符串 (默认北京时区) */ public static String format(long timestampMs) { return format(timestampMs, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 毫秒时间戳 - 指定格式、指定时区的时间字符串 */ public static String format(long timestampMs, String pattern, ZoneId zoneId) { Instant instant Instant.ofEpochMilli(timestampMs); ZonedDateTime zdt instant.atZone(zoneId); DateTimeFormatter formatter getFormatter(pattern); return zdt.format(formatter); } /** * 秒时间戳 - 默认格式的本地时间字符串 */ public static String formatFromSeconds(long timestampSec) { return format(timestampSec * 1000L, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 时间字符串 (默认北京时区) - 毫秒时间戳 */ public static long parseToMillis(String timeStr) throws DateTimeException { return parseToMillis(timeStr, DEFAULT_PATTERN, DEFAULT_ZONE); } /** * 时间字符串 (指定格式、时区) - 毫秒时间戳 */ public static long parseToMillis(String timeStr, String pattern, ZoneId zoneId) throws DateTimeException { DateTimeFormatter formatter getFormatter(pattern); LocalDateTime ldt LocalDateTime.parse(timeStr, formatter); ZonedDateTime zdt ldt.atZone(zoneId); return zdt.toInstant().toEpochMilli(); } /** * 获取当前时间的秒级时间戳 */ public static long currentTimeSeconds() { return Instant.now().getEpochSecond(); // 更清晰的方式 } /** * 获取当前时间的毫秒级时间戳 */ public static long currentTimeMillis() { return System.currentTimeMillis(); // 或者 Instant.now().toEpochMilli() } }6.2 常见场景示例public class CommonScenarios { public static void main(String[] args) { // 场景1生成订单号时间戳部分 String orderId ORD System.currentTimeMillis(); // 简单做法可能有并发重复风险 // 更佳做法结合机器ID、序列号等 // 场景2计算代码执行耗时 long start System.nanoTime(); // 纳秒用于精确测量短时间间隔 // ... 执行一些操作 ... long end System.nanoTime(); long durationMs (end - start) / 1_000_000L; // 转换为毫秒 System.out.println(操作耗时: durationMs 毫秒); // 对于更长的耗时直接用毫秒时间戳即可 long startMs System.currentTimeMillis(); // ... 执行一些操作 ... long endMs System.currentTimeMillis(); System.out.println(操作耗时: (endMs - startMs) 毫秒); // 场景3处理前端传递的ISO8601格式时间 String isoTimeStr 2024-05-13T18:30:4508:00; Instant instant Instant.from(DateTimeFormatter.ISO_OFFSET_DATE_TIME.parse(isoTimeStr)); System.out.println(解析ISO时间得到的时间戳: instant.toEpochMilli()); // 场景4与数据库交互 (以MyBatis为例) // 实体类中可以使用 java.time.LocalDateTime 类型字段 // 在MyBatis配置中需要合适的TypeHandler (如 org.apache.ibatis.type.LocalDateTimeTypeHandler) } }7. 性能考量与异常处理7.1 性能考量SimpleDateFormatvsDateTimeFormatterDateTimeFormatter不仅是线程安全的而且在多数情况下性能也优于SimpleDateFormat尤其是在高并发场景下避免了每次创建和销毁对象的开销。缓存Formatter模式字符串的解析是一个相对耗时的操作。如上文工具类所示将创建好的DateTimeFormatter实例缓存起来复用能有效提升性能。System.currentTimeMillis()vsInstant.now()两者获取当前毫秒时间戳的性能差异极小可忽略不计。Instant.now()能提供更高精度纳秒但System.currentTimeMillis()是更传统的写法。在Java 8环境中根据代码风格选择即可。7.2 异常处理时间转换中最常见的异常是解析异常。ParseException(SimpleDateFormat)当输入的字符串与定义的模式不匹配时抛出。务必在调用parse()方法时进行捕获和处理。DateTimeParseException(java.time)功能同上是java.time包中的对应异常。健壮的解析代码示例import java.time.DateTimeException; import java.time.format.DateTimeFormatter; import java.time.format.DateTimeParseException; public class RobustParsing { private static final DateTimeFormatter FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); public static Long safeParse(String timeStr) { if (timeStr null || timeStr.trim().isEmpty()) { return null; // 或根据业务逻辑返回默认值/抛出业务异常 } try { // 这里假设时间字符串是北京时间实际业务中时区应从别处获取 java.time.LocalDateTime ldt java.time.LocalDateTime.parse(timeStr, FORMATTER); return ldt.atZone(java.time.ZoneId.of(Asia/Shanghai)).toInstant().toEpochMilli(); } catch (DateTimeParseException e) { // 记录日志告警或转换为业务友好的异常抛出 System.err.println(无法解析时间字符串: timeStr , 错误: e.getMessage()); return null; // 或抛出自定义的 InvalidParameterException } } }时间戳与时间的转换是Java开发中的基础也是体现代码严谨性的细节。从理解时间戳的绝对性到掌握java.timeAPI的优雅用法再到妥善处理时区和异常每一步都关乎系统的稳定性和数据的准确性。希望这篇内容能帮你把这块知识拧清下次再遇到时间问题可以淡定地说“让我看看你的时间戳和时区。”