异常教程

Java 实例 – 时间戳转换成时间（千字长文）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，时间戳与日期时间的相互转换是一个高频需求。无论是处理日志记录、计算时间差，还是解析 API 返回的数据，开发者都需要掌握时间戳与可读时间格式之间的转换技巧。本文将以“Java 实例 – 时间戳转换成时间”为核心，通过循序渐进的方式，从基础概念到实战代码，结合生动的比喻和实际案例，帮助读者系统掌握这一技能。

一、时间戳与日期时间：基础概念与核心关系

1.1 时间戳的定义与特点

时间戳（Timestamp）本质上是自 1970 年 1 月 1 日 00:00:00 UTC（协调世界时）以来的毫秒或秒数。它是计算机系统记录时间的一种标准化方式，具有以下特点：

  • 唯一性：每个时间点对应一个唯一的数值，如 1717020800000 对应的是 2024 年 6 月 1 日 00:00:00。
  • 跨平台兼容性：时间戳与操作系统、编程语言无关，便于不同系统间的时间同步。
  • 数学计算友好：时间差的计算可通过数值相减直接实现。

比喻：可以把时间戳想象成时间的“身份证号”，它用一串数字精准地记录了某个瞬间的位置，但人类更习惯用“2024年6月1日”这样的自然语言描述，因此需要转换工具。

1.2 时间戳的常见单位

时间戳的单位通常有两种：

  1. 秒级时间戳（Unix Timestamp）：如 1717020800（对应 2024-06-01 00:00:00 UTC）。
  2. 毫秒级时间戳（Java 默认）：如 1717020800000（秒级的 1000 倍）。

注意：Java 中的 System.currentTimeMillis() 返回的是毫秒级时间戳。

二、Java 实现时间戳转时间的三种主流方法

2.1 方法一：使用 SimpleDateFormat（传统方式）

SimpleDateFormat 是 Java 早期提供的日期格式化工具，适合简单场景，但需注意其线程不安全的问题。

示例代码：将毫秒级时间戳转为日期字符串

import java.text.SimpleDateFormat;  
import java.util.Date;  

public class TimestampConverter {  
    public static void main(String[] args) {  
        long timestamp = 1717020800000L; // 示例时间戳  
        Date date = new Date(timestamp);  
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
        String formattedDate = sdf.format(date);  
        System.out.println("转换结果：" + formattedDate); // 输出 "2024-06-01 00:00:00"  
    }  
}

关键点解析

  • SimpleDateFormat 的格式字符串：
    • yyyy 表示四位年份，MM 表示两位月份，dd 表示两位日期。
    • HH 表示 24 小时制小时，mm 表示分钟，ss 表示秒。
  • 线程安全问题：
    若在多线程环境中使用，需通过 ThreadLocal 包装 SimpleDateFormat，避免数据竞争。

2.2 方法二：使用 LocalDateTime（Java 8+ 新特性）

Java 8 引入的 java.time 包（如 LocalDateTime）提供了更现代化的日期时间 API，支持线程安全且语法简洁。

示例代码：将毫秒级时间戳转为 LocalDateTime

import java.time.LocalDateTime;  
import java.time.ZoneId;  
import java.time.format.DateTimeFormatter;  

public class LocalDateTimeExample {  
    public static void main(String[] args) {  
        long timestamp = 1717020800000L; // 示例时间戳  
        LocalDateTime dateTime = LocalDateTime.ofInstant(  
            java.time.Instant.ofEpochMilli(timestamp),  
            ZoneId.systemDefault()  
        );  
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");  
        String formattedDateTime = dateTime.format(formatter);  
        System.out.println("转换结果：" + formattedDateTime); // 输出 "2024-06-01 00:00:00"  
    }  
}

关键点解析

  • LocalDateTime 的优势：
    • 线程安全：无需额外处理即可在多线程环境中安全使用。
    • 时区支持：通过 ZoneId 可指定目标时区，避免因时区差异导致的转换错误。
  • Instant 的作用：
    它是时间戳的载体，将毫秒值转换为 UTC 时间点，再通过 ZoneId 转换成本地时间。

2.3 方法三：使用 Calendar 类（兼容旧版本的过渡方案）

Calendar 是 Java 中较早的日期处理类，功能灵活但代码较为冗长，适合需要兼容旧版本的场景。

示例代码：通过 Calendar 实现时间戳转时间

import java.util.Calendar;  
import java.text.SimpleDateFormat;  

public class CalendarExample {  
    public static void main(String[] args) {  
        long timestamp = 1717020800000L;  
        Calendar calendar = Calendar.getInstance();  
        calendar.setTimeInMillis(timestamp);  
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
        String formattedDate = sdf.format(calendar.getTime());  
        System.out.println("转换结果：" + formattedDate); // 输出 "2024-06-01 00:00:00"  
    }  
}

关键点解析

  • Calendar 的局限性：
    • 代码冗长，且需配合 SimpleDateFormat 使用，线程安全问题依然存在。
    • 推荐在新项目中优先使用 LocalDateTime 替代。

三、扩展应用：时间戳转换的常见场景与最佳实践

3.1 场景一：解析 API 返回的时间戳

许多 RESTful API 返回时间戳作为响应数据，例如：

{  
  "event_time": 1717020800000,  
  "description": "系统启动时间"  
}

开发者可通过上述方法将 event_time 转换为可读格式，并在前端或日志中展示。

3.2 场景二：日志时间格式化

在日志系统中，时间戳常以毫秒级存储，但需转换为更易读的格式：

// 示例日志输出  
public class Logger {  
    public static void logEvent(String message) {  
        long now = System.currentTimeMillis();  
        String formattedTime = convertTimestampToString(now);  
        System.out.println("[" + formattedTime + "] " + message);  
    }  
}

3.3 最佳实践总结

场景推荐方法注意事项
简单单线程环境SimpleDateFormat避免多线程使用
复杂多线程场景LocalDateTime明确时区配置
兼容旧代码或特殊需求Calendar配合 SimpleDateFormat

四、常见问题与解决方案

4.1 时区导致的转换错误

时间戳默认是 UTC 时间，若未指定本地时区，可能导致显示错误。例如：

// 错误示例：未指定时区  
LocalDateTime dateTime = LocalDateTime.ofInstant(  
    Instant.ofEpochMilli(timestamp),  
    ZoneId.of("UTC") // 必须明确时区  
);

解决方案：
始终通过 ZoneId.systemDefault() 或显式指定目标时区（如 ZoneId.of("Asia/Shanghai")）。

4.2 性能优化：避免频繁创建 SimpleDateFormat

在循环中重复创建 SimpleDateFormat 对象会显著降低性能。

// 低效写法  
for (long ts : timestamps) {  
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");  
    // ...  
}

优化方案：
使用 ThreadLocal<SimpleDateFormat> 或提前实例化对象：

private static final SimpleDateFormat SDF = new SimpleDateFormat("yyyy-MM-dd");

结论

通过本文的讲解，读者应已掌握 Java 中时间戳与日期时间转换的核心方法，包括 SimpleDateFormat、LocalDateTime 和 Calendar 的使用场景及注意事项。在实际开发中，建议优先采用 LocalDateTime，因其兼具线程安全与简洁性，同时需注意时区配置和性能优化。

时间戳转换不仅是技术问题，更是开发者理解时间本质的桥梁。通过不断实践与案例积累，读者将能灵活应对各类时间相关需求，为构建高质量的 Java 应用打下坚实基础。

关键词布局自然融入：

  • 标题与小标题直接关联“Java 实例 – 时间戳转换成时间”
  • 正文通过代码示例和场景描述间接呼应主题
  • 结论部分再次强调技能的重要性，强化读者对关键词的认知

最新发布

查看更多文章