Java 实例 – 时间戳转换成时间（完整指南）

Java 实例 – 时间戳转换成时间：从毫秒到人类可读时间的完整指南

在 Java 开发中，我们经常需要处理时间相关的逻辑。尤其是在处理日志、数据库记录、API 接口数据时，时间戳（timestamp）是一种常见的时间表示方式。它本质上是自 1970 年 1 月 1 日 00:00:00 UTC 起经过的毫秒数。虽然对计算机来说很高效，但对人类来说却难以理解。因此，将时间戳转换为可读的日期时间格式，就成了开发中非常实用的一个技能。

今天，我们就来深入探讨 Java 实例 – 时间戳转换成时间 的多种实现方式，从基础到进阶，手把手带你掌握这项核心能力。

什么是时间戳？为什么需要转换？

时间戳，简单来说就是“从世界标准时间起点开始算起的毫秒数”。你可以把它想象成一个计时器，从 1970 年开始一直滴答滴答走，每过 1 毫秒就加 1。这个数字在系统间传输非常高效，占用空间小，适合存储和比较。

但问题来了：当你看到一个数字 1712345678900，你能立刻知道这是哪一天、几点几分吗？显然不能。所以，时间戳转换成时间，就是让计算机“翻译”这个数字，变成我们熟悉的格式，比如：2024-04-05 10:14:38。

这个过程，在 Java 中有多种方法可以实现，下面我们逐一介绍。

使用 Date 类进行时间戳转换（旧版方式）

虽然 Date 类在 Java 8 之后被推荐使用 LocalDateTime 等新类替代，但它的历史地位不可忽视，尤其在处理遗留代码时依然常见。

import java.util.Date;

public class TimestampToTimeExample {
    public static void main(String[] args) {
        // 假设这是从数据库或接口获取的时间戳（毫秒级）
        long timestamp = 1712345678900L;

        // 将时间戳转换为 Date 对象
        Date date = new Date(timestamp);

        // 输出结果
        System.out.println("原始时间戳: " + timestamp);
        System.out.println("转换后的日期时间: " + date);
    }
}

代码注释说明：

• long timestamp = 1712345678900L;：定义一个时间戳变量，注意末尾加 L 表示长整型，避免类型不匹配。
• Date date = new Date(timestamp);：构造函数接收毫秒数，自动转换为对应的日期时间。
• System.out.println(date);：默认输出格式为 EEE MMM dd HH:mm:ss zzz yyyy，例如 Fri Apr 05 10:14:38 CST 2024。

⚠️ 注意：Date 类的 toString() 方法输出的格式不够直观，适合调试，不适合正式展示。

使用 SimpleDateFormat 格式化输出（推荐基础方案）

为了更清晰地展示时间，我们可以使用 SimpleDateFormat 类来定义输出格式。

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

public class FormatTimestamp {
    public static void main(String[] args) {
        long timestamp = 1712345678900L;

        // 创建 SimpleDateFormat 对象，指定输出格式
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        // 将时间戳转换为 Date，再格式化
        Date date = new Date(timestamp);
        String formattedTime = sdf.format(date);

        System.out.println("原始时间戳: " + timestamp);
        System.out.println("格式化后的时间: " + formattedTime);
    }
}

代码注释说明：

• SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");：定义了格式模板，“yyyy” 表示四位年份，“MM” 是月份，“dd” 是日期，HH 是 24 小时制，mm 是分钟，ss 是秒。
• sdf.format(date)：将 Date 对象按照模板格式化为字符串。
• 输出结果：2024-04-05 10:14:38

这个方式简单直接，适合大多数日常开发场景，比如日志输出、前端数据展示等。

使用 Java 8 的 LocalDateTime（现代推荐方式）

Java 8 引入了全新的时间 API，包括 LocalDateTime、ZonedDateTime、Instant 等，它们设计更合理，线程安全，功能强大。

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

public class ModernTimestampConversion {
    public static void main(String[] args) {
        long timestamp = 1712345678900L;

        // Step 1: 将时间戳转换为 Instant（时间点）
        Instant instant = Instant.ofEpochMilli(timestamp);

        // Step 2: 转换为本地时间（默认时区）
        LocalDateTime localDateTime = instant.atZone(ZoneId.systemDefault()).toLocalDateTime();

        // Step 3: 格式化输出
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        String formattedTime = localDateTime.format(formatter);

        System.out.println("原始时间戳: " + timestamp);
        System.out.println("转换后的时间: " + formattedTime);
    }
}

代码注释说明：

• Instant.ofEpochMilli(timestamp)：将毫秒时间戳转换为 Instant 类型，这是 Java 8 时间 API 的核心类，表示一个时间点。
• atZone(ZoneId.systemDefault())：将时间点转换为某个时区的 ZonedDateTime，systemDefault() 获取系统默认时区。
• toLocalDateTime()：提取出本地日期时间部分。
• DateTimeFormatter.ofPattern(...)：定义格式化规则。
• format(formatter)：执行格式化，输出可读字符串。

✅ 优势：线程安全、语义清晰、支持多种时区、易于扩展。

处理不同时间戳单位的差异（毫秒 vs 秒）

有时候，时间戳可能是以“秒”为单位，而不是毫秒。比如某些数据库或第三方接口返回的是秒级时间戳。

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

public class SecondTimestampConversion {
    public static void main(String[] args) {
        long secondTimestamp = 1712345678L; // 以秒为单位

        // 注意：需要乘以 1000 转换为毫秒
        long milliTimestamp = secondTimestamp * 1000L;

        // 使用现代 API 转换
        Instant instant = Instant.ofEpochMilli(milliTimestamp);
        LocalDateTime localDateTime = instant.atZone(ZoneId.systemDefault()).toLocalDateTime();

        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        String formattedTime = localDateTime.format(formatter);

        System.out.println("原始秒级时间戳: " + secondTimestamp);
        System.out.println("转换后的时间: " + formattedTime);
    }
}

关键点提醒：

• 如果你收到的时间戳是“秒”为单位，请务必乘以 1000 再传给 Instant.ofEpochMilli()。
• 否则会得到一个错误的时间（比如 1970 年的某个时间）。

实际应用案例：日志系统中的时间戳转换

假设你在开发一个日志系统，日志条目包含时间戳字段。你需要将其转换为可读时间用于展示。

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

public class LogSystemExample {
    public static void main(String[] args) {
        // 模拟日志数据
        String[] logs = {
            "1712345678900", // 2024-04-05 10:14:38
            "1712345689000", // 2024-04-05 10:14:49
            "1712345699100"  // 2024-04-05 10:15:00
        };

        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

        for (String log : logs) {
            long timestamp = Long.parseLong(log);
            Instant instant = Instant.ofEpochMilli(timestamp);
            LocalDateTime localDateTime = instant.atZone(ZoneId.systemDefault()).toLocalDateTime();
            String readableTime = localDateTime.format(formatter);

            System.out.println("时间戳: " + log + " → " + readableTime);
        }
    }
}

输出结果：

时间戳: 1712345678900 → 2024-04-05 10:14:38
时间戳: 1712345689000 → 2024-04-05 10:14:49
时间戳: 1712345699100 → 2024-04-05 10:15:00

这个例子展示了 Java 实例 – 时间戳转换成时间 在真实项目中的典型应用场景，逻辑清晰，易于维护。

常见问题与注意事项

总结：掌握时间戳转换，提升开发效率

时间戳转换是 Java 开发中的高频操作，掌握它不仅能让你的代码更专业，还能避免因时间格式混乱导致的 Bug。

从 Date 到 SimpleDateFormat，再到 Java 8 的 LocalDateTime 和 Instant，我们看到的是 Java 时间处理能力的演进。Java 实例 – 时间戳转换成时间，不仅仅是一个代码片段，更是一种思维方式的升级。

建议新项目一律使用 Java 8 的时间 API，它更安全、更易读、更可维护。而面对旧项目，也应逐步替换 Date 和 SimpleDateFormat，提升整体代码质量。

最后，别忘了：时间是唯一的资源，不要让它在格式转换中浪费。掌握这项技能，你离一个优秀的 Java 开发者，又近了一步。