萬盛學電腦網

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

JavaScript 日期格式化深度解析:從原理到生產級工具函數

核心痛點

原生 Date 僅提供 toString/toISOString/toLocaleString 等固定格式,無法自定義如 yyyy-MM-dd HH:mm:ss、yyyy年MM月dd日 等業務格式。

實現原理

  1. 提取字段: getFullYear(), getMonth() (0-11), getDate(), getHours(), getMinutes(), getSeconds(), getMilliseconds(), getDay() (0-6 周日-周六)
  2. 模板解析: 正則匹配格式化標記(yyyy, MM, dd 等)
  3. 替換填充: 按標記長度補零(M→9, MM→09)
  4. 國際化: 月份/星期名稱本地化
  5. 時區處理: UTC vs 本地時間

輕量級實現(<1KB,無依賴)

/**
 * 日期格式化
 * @param {Date|number|string} date - 日期對象/時間戳/可解析字符串
 * @param {string} fmt - 格式模板,默認 'yyyy-MM-dd HH:mm:ss'
 * @param {boolean} utc - 是否用 UTC 時間
 * @returns {string}
 */
function formatDate(date, fmt = 'yyyy-MM-dd HH:mm:ss', utc = false) {
  if (!date) return '';
  const d = date instanceof Date ? date : new Date(date);
  if (isNaN(d.getTime())) return 'Invalid Date';
  
  const get = utc ? 'getUTC' : 'get';
  const pad = (n, len = 2) => String(n).padStart(len, '0');
  
  // 字段映射
  const fields = {
    'yyyy': d[get + 'FullYear'](),
    'yy': String(d[get + 'FullYear']()).slice(-2),
    'M': d[get + 'Month']() + 1,
    'MM': pad(d[get + 'Month']() + 1),
    'MMM': ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'][d[get + 'Month']()],
    'MMMM': ['January','February','March','April','May','June','July','August','September','October','November','December'][d[get + 'Month']()],
    'd': d[get + 'Date'](),
    'dd': pad(d[get + 'Date']()),
    'H': d[get + 'Hours'](),
    'HH': pad(d[get + 'Hours']()),
    'h': d[get + 'Hours']() % 12 || 12,
    'hh': pad(d[get + 'Hours']() % 12 || 12),
    'm': d[get + 'Minutes'](),
    'mm': pad(d[get + 'Minutes']()),
    's': d[get + 'Seconds'](),
    'ss': pad(d[get + 'Seconds']()),
    'S': d[get + 'Milliseconds'](),
    'SS': pad(d[get + 'Milliseconds'](), 3),
    'SSS': pad(d[get + 'Milliseconds'](), 3),
    'E': ['Sun','Mon','Tue','Wed','Thu','Fri','Sat'][d[get + 'Day']()],
    'EE': ['Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday'][d[get + 'Day']()],
    'e': ['日','一','二','三','四','五','六'][d[get + 'Day']()],
    'ee': ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'][d[get + 'Day']()],
    'Z': utc ? 'Z' : (() => { const o = d.getTimezoneOffset(); const s = o < 0 ? '+' : '-'; const h = pad(Math.abs(o/60)|0); const m = pad(Math.abs(o%60)); return `${s}${h}:${m}`; })()
  };
  
  // 單次正則替換所有標記(按長度降序避免 yy 被 yyyy 部分匹配)
  return fmt.replace(/yyyy|yy|MMMM|MMM|MM|M|dd|d|HH|H|hh|h|mm|m|ss|s|SSS|SS|S|EE|E|ee|e|Z/g, m => fields[m] || m);
}

使用示例

const now = new Date();

formatDate(now);                          // "2024-01-15 14:30:45"
formatDate(now, 'yyyy/MM/dd');            // "2024/01/15"
formatDate(now, 'yyyy年MM月dd日');          // "2024年01月15日"
formatDate(now, 'HH:mm:ss.SSS');          // "14:30:45.123"
formatDate(now, 'yyyy-MM-ddTHH:mm:ssZ');  // "2024-01-15T14:30:45+08:00"
formatDate(now, 'EEEE, MMMM d, yyyy');    // "Monday, January 15, 2024"
formatDate(1705300245123, 'yyyy-MM-dd');  // 時間戳輸入
formatDate('2024-01-15', 'yyyy年MM月dd日'); // 字符串輸入
formatDate(now, 'yyyy-MM-dd HH:mm:ss', true); // UTC 時間

掛載到 Date.prototype(可選,慎用)

// 僅開發環境/內部項目使用,避免污染全局原型
if (process.env.NODE_ENV !== 'production') {
  Date.prototype.format = function(fmt, utc) {
    return formatDate(this, fmt, utc);
  };
}

// 使用
new Date().format('yyyy-MM-dd'); // "2024-01-15"

企業級增強版功能

const DateFormatter = (() => {
  // 緩存編譯後的格式化函數
  const cache = new Map();
  
  // 國際化配置
  const locales = {
    'zh-CN': {
      months: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
      monthsShort: ['1月','2月','3月','4月','5月','6月','7月','8月','9月','10月','11月','12月'],
      weekdays: ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'],
      weekdaysShort: ['周日','周一','周二','周三','周四','周五','周六'],
      meridiem: (h) => h < 12 ? '上午' : '下午'
    },
    'en-US': { /* ... */ }
  };
  
  function compile(fmt, locale = 'zh-CN') {
    const key = fmt + '|' + locale;
    if (cache.has(key)) return cache.get(key);
    
    const loc = locales[locale];
    // 預編譯正則與替換邏輯...
    const fn = (date, utc) => { /* 高性能實現 */ };
    cache.set(key, fn);
    return fn;
  }
  
  return {
    format(date, fmt, options = {}) {
      const { locale = 'zh-CN', utc = false } = options;
      return compile(fmt, locale)(date, utc);
    },
    
    registerLocale(name, def) {
      locales[name] = def;
    },
    
    // 相對時間
    fromNow(date, locale = 'zh-CN') {
      const diff = Date.now() - new Date(date).getTime();
      const sec = diff / 1000;
      if (sec < 60) return '剛剛';
      if (sec < 3600) return Math.floor(sec/60) + '分鐘前';
      if (sec < 86400) return Math.floor(sec/3600) + '小時前';
      if (sec < 604800) return Math.floor(sec/86400) + '天前';
      return this.format(date, 'yyyy-MM-dd', { locale });
    }
  };
})();

// 使用
DateFormatter.format(new Date(), 'yyyy年MM月dd日 EE'); // "2024年01月15日 周一"
DateFormatter.fromNow('2024-01-15 10:00'); // "4小時前"

生產環境推薦庫

庫體積特點適用場景
date-fns~20KB (ESM tree-shaking 後更小)純函數、不可變、TypeScript 優先、模塊化按需引入現代項目首選
dayjs~2KBAPI 兼容 Moment.js、不可變、插件化、國際化遷移 Moment 項目、體積敏感
Moment.js~16KB (含 locale 更大)功能最全、可變對象、停止維護維護老項目
Luxon~12KB基於 Intl API、不可變、時區支持強複雜時區業務
原生 Intl.DateTimeFormat0KB瀏覽器內置、無依賴、性能最強簡單本地化格式化

Intl.DateTimeFormat 原生方案(零依賴)

function formatDateIntl(date, locale = 'zh-CN', options = {}) {
  const defaultOpts = {
    year: 'numeric', month: '2-digit', day: '2-digit',
    hour: '2-digit', minute: '2-digit', second: '2-digit',
    hour12: false
  };
  return new Intl.DateTimeFormat(locale, { ...defaultOpts, ...options }).format(date);
}

formatDateIntl(new Date(), 'zh-CN'); // "2024/01/15 14:30:45"
formatDateIntl(new Date(), 'zh-CN', { dateStyle: 'long' }); // "2024年1月15日"
formatDateIntl(new Date(), 'en-US', { timeStyle: 'short' }); // "2:30 PM"
copyright © 萬盛學電腦網 all rights reserved