萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 時間轉換:毫秒輕鬆轉日期時間的完整指南

前言

在 JavaScript 開發中,時間戳(毫秒數)與可讀日期格式的互轉是極常見的需求。本文將詳細介紹如何利用 Date 物件內建方法,快速完成毫秒轉日期時間,並說明常見陷阱與最佳實踐。

核心概念:Date 物件的雙向轉換

JavaScript 的 Date 建構函數支援傳入毫秒數作為參數,直接產生對應的日期物件;反之,呼叫 getTime() 即可取得該日期距離 1970-01-01 00:00:00 UTC 的毫秒數。這雙向特性讓轉換變得極其簡單。

範例程式碼

// 1. 日期 → 毫秒
const oldTime = new Date("2011/11/11 20:10:10").getTime();
console.log(oldTime); // 1321013410000

// 2. 毫秒 → 日期(核心技巧)
const newTime = new Date(oldTime);
console.log(newTime); // Fri Nov 11 2011 20:10:10 GMT+0800 (中國標準時間)

// 3. 取出具體年月日時分秒
console.log(newTime.getFullYear()); // 2011
console.log(newTime.getMonth() + 1); // 11(月份從 0 開始)
console.log(newTime.getDate()); // 11
console.log(newTime.getHours()); // 20
console.log(newTime.getMinutes()); // 10
console.log(newTime.getSeconds()); // 10

為什麼不建議手動換算?

早期開發者常嘗試用「毫秒 ÷ (365×24×60×60×1000)」換算年份,但這忽略了閏年(366 天)、月份天數不一、時區、夏令時間等複雜因素,極易產生誤差。直接交給 Date 物件處理才是正解。

進階應用:格式化輸出

若需自訂格式(如 YYYY-MM-DD HH:mm:ss),可封裝工具函式:

function formatDate(ms, fmt = "YYYY-MM-DD HH:mm:ss") {
  const d = new Date(ms);
  const pad = (n) => String(n).padStart(2, "0");
  return fmt
    .replace("YYYY", d.getFullYear())
    .replace("MM", pad(d.getMonth() + 1))
    .replace("DD", pad(d.getDate()))
    .replace("HH", pad(d.getHours()))
    .replace("mm", pad(d.getMinutes()))
    .replace("ss", pad(d.getSeconds()));
}

console.log(formatDate(oldTime)); // 2011-11-11 20:10:10

常見坑點提醒

  • 月份索引從 0 開始:getMonth() 回傳 0~11,顯示時須 +1。
  • 時區影響:Date 預設用本地時區;若需 UTC,請改用 getUTCFullYear() 等方法。
  • 無效輸入:傳入非數字或超出範圍的毫秒數會得到 Invalid Date,建議先用 isNaN(date.getTime()) 檢查。

總結

毫秒轉日期時間,只要 new Date(毫秒數) 即可搞定,再配合 getFullYear()、getMonth() 等方法取出各欄位。拋棄手動換算,擁抱原生 API,程式碼更簡潔、可維護性更高。

copyright © 萬盛學電腦網 all rights reserved