萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java 將毫秒時間戳轉換為可讀日期格式完整範例

需求背景

電腦等級考試與實務開發中,常需將 13 位數毫秒時間戳(如 1699872000000)轉為 yyyy-MM-dd HH:mm:ss 格式。本文提供完整可執行的 Swing GUI 範例。

核心轉換邏輯

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

public class TimestampConverter {
    private static final SimpleDateFormat SDF = 
        new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

    /** 將毫秒長整數轉為格式化日期字串 */
    public static String convert(long milliseconds) {
        return SDF.format(new Date(milliseconds));
    }

    public static void main(String[] args) {
        // 測試:2023-11-13 20:00:00 對應的毫秒數
        long ts = 1699872000000L;
        System.out.println(convert(ts)); // 輸出: 2023-11-13 20:00:00
    }
}

完整 GUI 互動版(含原始碼註解)

import java.awt.*;
import java.awt.event.*;
import java.text.SimpleDateFormat;
import java.util.Date;

public class TimestampConverterGUI extends Frame {
    private final TextField inputField = new TextField(20);
    private final TextArea outputArea = new TextArea(5, 40);
    private static final SimpleDateFormat SDF = 
        new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

    public static void main(String[] args) {
        new TimestampConverterGUI().launch();
    }

    public void launch() {
        setTitle("毫秒時間戳轉換工具");
        setLayout(new BorderLayout(5, 5));
        setSize(480, 320);
        setLocationRelativeTo(null); // 置中
        setResizable(false);

        // 頂部輸入區
        Panel top = new Panel(new BorderLayout());
        top.add(new Label("輸入毫秒時間戳 (按 Enter 轉換):"), BorderLayout.NORTH);
        top.add(inputField, BorderLayout.CENTER);
        add(top, BorderLayout.NORTH);

        // 底部輸出區
        outputArea.setEditable(false);
        add(new ScrollPane(outputArea), BorderLayout.CENTER);

        // 事件監聽
        inputField.addActionListener(e -> convertAndShow());
        addWindowListener(new WindowAdapter() {
            @Override public void windowClosing(WindowEvent e) { System.exit(0); }
        });

        setVisible(true);
    }

    private void convertAndShow() {
        String text = inputField.getText().trim();
        if (text.isEmpty()) return;

        try {
            long ms = Long.parseLong(text);
            String formatted = SDF.format(new Date(ms));
            outputArea.setText(formatted);
        } catch (NumberFormatException ex) {
            outputArea.setText("錯誤:請輸入有效的長整數毫秒數");
        } finally {
            inputField.setText(""); // 清空輸入框
        }
    }
}

關鍵技術點

  1. SimpleDateFormat 非執行緒安全:此處為單執行緒 GUI 直接用 static 實例;多執行緒環境請用 ThreadLocal 或 Java 8 DateTimeFormatter
  2. Date 建構子接受毫秒:new Date(long ms) 直接對應 Unix epoch 毫秒
  3. Swing/AWT 基礎:Frame、TextField、TextArea、ActionListener、WindowAdapter 組合

現代化替代方案(Java 8+)

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

public class ModernConverter {
    private static final DateTimeFormatter FMT = 
        DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")
                         .withZone(ZoneId.systemDefault());

    public static String convert(long ms) {
        return FMT.format(Instant.ofEpochMilli(ms));
    }
}

java.time 套件執行緒安全、效能更好、API 更豐富,新專案首選。

常見錯誤提醒

  • 輸入秒級時間戳(10 位數)需乘 1000:ms = seconds * 1000L
  • 時區問題:SimpleDateFormat 預設用系統時區,跨時區應用需顯式 setTimeZone()
  • 年份格式:yyyy 為曆年,YYYY 為週年(ISO 週年),易混淆導致跨年錯誤
copyright © 萬盛學電腦網 all rights reserved