萬盛學電腦網

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

JavaScript 時間戳轉日期格式完全指南:10位/13位時間戳統一處理與格式化工具函數

後端返回的時間戳可能是 10 位(秒級,PHP 常見)或 13 位(毫秒級,Java/JS 常見)。本文提供統一處理函數,自動識別位數並正確轉換為 YYYY-MM-DD 等常用格式,含零填充工具函數與擴展格式化方案。

核心差異:10位 vs 13位

類型位數單位典型來源JS 處理
秒級10秒PHP time(), Unix 標準× 1000 轉毫秒
毫秒級13毫秒Java System.currentTimeMillis(), JS Date.now()直接使用

統一處理函數

/**
 * 通用時間戳格式化函數
 * @param {number|string} timestamp - 10位(秒)或13位(毫秒)時間戳
 * @param {string} format - 輸出格式,默認 'YYYY-MM-DD'
 * @returns {string} 格式化日期字串
 */
function formatTimestamp(timestamp, format) {
  // 1. 統一轉為數字
  var ts = Number(timestamp);
  if (isNaN(ts)) return 'Invalid Date';
  
  // 2. 自動識別並統一為毫秒
  // 10位最大值 2147483647 (2038年),13位當前已達 1.7e12
  if (ts < 1e11) { // 經驗閾值:1000億 (約 1973年)
    ts *= 1000; // 秒轉毫秒
  }
  
  // 3. 創建 Date 對象
  var date = new Date(ts);
  if (isNaN(date.getTime())) return 'Invalid Date';
  
  // 4. 格式化輸出
  var year = date.getFullYear();
  var month = padZero(date.getMonth() + 1); // 0-11 → 1-12
  var day = padZero(date.getDate());
  var hours = padZero(date.getHours());
  var minutes = padZero(date.getMinutes());
  var seconds = padZero(date.getSeconds());
  
  // 默認格式
  format = format || 'YYYY-MM-DD';
  
  return format
    .replace('YYYY', year)
    .replace('MM', month)
    .replace('DD', day)
    .replace('HH', hours)
    .replace('mm', minutes)
    .replace('ss', seconds);
}

/** 零填充工具函數 */
function padZero(num) {
  return num < 10 ? '0' + num : String(num);
}

使用示例

// PHP 返回的 10 位時間戳
var phpTime = 1379347200; // 2013-09-16
console.log(formatTimestamp(phpTime));           // "2013-09-16"
console.log(formatTimestamp(phpTime, 'YYYY-MM-DD HH:mm:ss')); // "2013-09-16 00:00:00"

// Java/JS 返回的 13 位時間戳
var jsTime = 1379347200000;
console.log(formatTimestamp(jsTime));            // "2013-09-16"
console.log(formatTimestamp(jsTime, 'YYYY/MM/DD')); // "2013/09/16"

// 當前時間
console.log(formatTimestamp(Date.now(), 'HH:mm:ss')); // 當前時間

原始代碼對比(教學用)

// 原始寫法 1:PHP 10位需乘 1000
var mystime = new Date(msg.pager.result[i].adsdate * 1000);
var addstime = mystime.getFullYear() + '-' + 
  padZero(mystime.getMonth() + 1) + '-' + 
  padZero(mystime.getDate());

// 原始寫法 2:Java 13位直接用
var mystime = new Date(msg.pager.result[i].adsdate);
var addstime = mystime.getFullYear() + '-' + 
  padZero(mystime.getMonth() + 1) + '-' + 
  padZero(mystime.getDate());

進階:功能更強的格式化庫推薦

  • date-fns:模組化、Tree-shaking 友好、format(date, 'yyyy-MM-dd')
  • dayjs:2KB 輕量、API 與 Moment.js 一致、dayjs(ts).format('YYYY-MM-DD')
  • Moment.js:功能最全但體積大、已停止維護(進入維護模式)
  • Intl.DateTimeFormat:原生國際化 API,無依賴

原生 Intl 方案(零依賴,現代瀏覽器)

function formatWithIntl(timestamp, locale = 'zh-CN', options = {}) {
  var ts = Number(timestamp);
  if (ts < 1e11) ts *= 1000;
  var date = new Date(ts);
  
  var defaultOptions = { 
    year: 'numeric', month: '2-digit', day: '2-digit',
    hour: '2-digit', minute: '2-digit', second: '2-digit',
    hour12: false 
  };
  
  return new Intl.DateTimeFormat(locale, { ...defaultOptions, ...options }).format(date);
}

// 使用
formatWithIntl(Date.now()); // "2024/01/15, 14:30:25"
formatWithIntl(Date.now(), 'zh-CN', { dateStyle: 'short' }); // "2024/1/15"

常見坑點總結

  1. 月份 0-11:getMonth() 需 +1
  2. 時區陷阱:new Date() 使用本地時區,跨時區業務用 UTC 方法
  3. 無效日期:new Date('invalid') 返回 Invalid Date,需檢查 isNaN(date.getTime())
  4. 年份 2000 問題:getYear() 已棄用,必須用 getFullYear()
copyright © 萬盛學電腦網 all rights reserved