在 JavaScript 開發中,時間戳(毫秒數)與可讀日期格式的互轉是極常見的需求。本文將詳細介紹如何利用 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
getMonth() 回傳 0~11,顯示時須 +1。Date 預設用本地時區;若需 UTC,請改用 getUTCFullYear() 等方法。Invalid Date,建議先用 isNaN(date.getTime()) 檢查。毫秒轉日期時間,只要 new Date(毫秒數) 即可搞定,再配合 getFullYear()、getMonth() 等方法取出各欄位。拋棄手動換算,擁抱原生 API,程式碼更簡潔、可維護性更高。