萬盛學電腦網

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

JavaScript 日期格式化為字符串:高性能模板替換實現

設計目標

  • 支持任意分隔符(-, /, 空格, 中文、無分隔符)
  • 支持年月日時分秒毫秒所有字段
  • 支持中文月份名(一、二...十二)
  • 單次正則解析,O(n) 線性替換,高性能
  • 無依賴、可樹搖、TypeScript 友好

核心實現

/**
 * 高性能日期格式化
 * @param {Date|number|string} date - 日期對象/時間戳/ISO字符串
 * @param {string} format - 格式模板
 * @returns {string}
 */
function formatDate(date, format) {
  const d = date instanceof Date ? date : new Date(date);
  if (isNaN(d.getTime())) throw new Error('Invalid Date');
  
  // 配置:中文月份名
  const cfg = {
    MMM: ['一','二','三','四','五','六','七','八','九','十','十一','十二'],
    MMMM: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月']
  };
  
  // 字段值映射
  const values = {
    y: d.getFullYear(),
    M: d.getMonth(),        // 0-11
    d: d.getDate(),
    H: d.getHours(),
    m: d.getMinutes(),
    s: d.getSeconds(),
    S: d.getMilliseconds()
  };
  
  // 1. 正則拆分:連續字母字段 + 非字母分隔符
  // y+|M+|d+|H+|m+|s+|S+|[^yMdHmsS]+
  const tokens = format.match(/y+|M+|d+|H+|m+|s+|S+|[^yMdHmsS]+/g);
  if (!tokens) return '';
  
  // 2. 替換每個 token
  for (let i = 0; i < tokens.length; i++) {
    const token = tokens[i];
    const firstChar = token[0];
    
    if (cfg[token]) {
      // 直接映射(如 MMM, MMMM)
      tokens[i] = cfg[token][values[firstChar]];
    } else if (values[firstChar] !== undefined) {
      // 數字字段:根據 token 長度補零
      const val = values[firstChar];
      const len = token.length;
      tokens[i] = String(val).padStart(len, '0');
    }
    // 分隔符保持不變
  }
  
  return tokens.join('');
}

格式標記完整對照

標記含義示例輸出備註
y, yy, yyy, yyyy年份24, 2024, 2024, 2024yy 取後兩位
M月份(1-12)1, 12不補零
MM月份(01-12)01, 12補零
MMM月份簡稱一, 十二中文數字
MMMM月份全稱一月, 十二月中文
d日期(1-31)1, 31不補零
dd日期(01-31)01, 31補零
H24制小時(0-23)0, 23
HH24制小時(00-23)00, 23補零
h12制小時(1-12)1, 12
hh12制小時(01-12)01, 12補零
m分鐘(0-59)0, 59
mm分鐘(00-59)00, 59補零
s秒(0-59)0, 59
ss秒(00-59)00, 59補零
S毫秒(0-999)5, 123不補零
SS毫秒(00-999)05, 123補零到2位
SSS毫秒(000-999)005, 123補零到3位

使用示例

const now = new Date('2024-01-15T14:30:45.123');

formatDate(now, 'yyyy-MM-dd');           // "2024-01-15"
formatDate(now, 'yyyy/MM/dd');           // "2024/01/15"
formatDate(now, 'yyyy年MM月dd日');         // "2024年01月15日"
formatDate(now, 'yyyyMMdd');             // "20240115" (無分隔符)
formatDate(now, 'HH:mm:ss');             // "14:30:45"
formatDate(now, 'HH:mm:ss.SSS');         // "14:30:45.123"
formatDate(now, 'yyyy-MM-dd HH:mm:ss');  // "2024-01-15 14:30:45"
formatDate(now, 'hh:mm:ss');             // "02:30:45" (12制)
formatDate(now, 'MMM月dd日');             // "一月15日"
formatDate(now, 'MMMM');                 // "一月"

擴展:星期支持


function formatDateEx(date, format) {
  const d = date instanceof Date ? date : new Date(date);
  if (isNaN(d.getTime())) return '';
  
  const cfg = {
    MMM: ['一','二','三','四','五','六','七','八','九','十','十一','十二'],
    MMMM: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
    EE: ['日','一','二','三','四','五','六'],
    EEE: ['星期日','星期一','星期二','星期三','星期四','星期五','星期六']
  };
  
  const values = {
    y: d.getFullYear(),
    M: d.getMonth(),
    d: d.getDate(),
    H: d.getHours(),
    m: d.getMinutes(),
    s: d.getSeconds(),
    S: d.getMilliseconds(),
    E: d.getDay() // 0-6
  };
  
  // 正則加入 E+/e+
  const tokens = format.match(/y+|M+|d+|H+|m+|s+|S+|E+|e+|[^yMdHmsSEe]+/g);
  
  for (let i = 0; i < tokens.length; i++) {
    const token = tokens[i];
    const firstChar = token[0];
    
    if (cfg[token]) {
      tokens[i] = cfg[token][values[firstChar]];
    } else if (values[firstChar] !== undefined) {
      tokens[i] = String(values[firstChar]).padStart(token.length, '0');
    }
  }
  
  return tokens.join('');
}

// 使用
formatDateEx(now, 'yyyy-MM-dd EEE'); // "2024-01-15 星期一"
formatDateEx(now, 'yyyy-MM-dd EE');  // "2024-01-15 一"

性能優化:預編譯緩存


const formatCache = new Map();

function createFormatter(format) {
  if (formatCache.has(format)) return formatCache.get(format);
  
  // 預解析 tokens
  const tokens = format.match(/y+|M+|d+|H+|m+|s+|S+|[^yMdHmsS]+/g);
  const parsed = tokens.map(token => {
    if (/^[yMdHmsS]+$/.test(token)) {
      return { type: 'field', key: token[0], len: token.length };
    } else if (cfg[token]) {
      return { type: 'map', key: token[0], map: cfg[token] };
    } else {
      return { type: 'literal', value: token };
    }
  });
  
  const fn = (date) => {
    const d = date instanceof Date ? date : new Date(date);
    if (isNaN(d.getTime())) return '';
    
    const vals = {
      y: d.getFullYear(),
      M: d.getMonth(),
      d: d.getDate(),
      H: d.getHours(),
      m: d.getMinutes(),
      s: d.getSeconds(),
      S: d.getMilliseconds()
    };
    
    return parsed.map(t => {
      if (t.type === 'field') return String(vals[t.key]).padStart(t.len, '0');
      if (t.type === 'map') return t.map[vals[t.key]];
      return t.value;
    }).join('');
  };
  
  formatCache.set(format, fn);
  return fn;
}

// 使用:同一格式複用 formatter
const fmtYMD = createFormatter('yyyy-MM-dd');
fmtYMD(new Date()); // 極快,無正則開銷
fmtYMD(Date.now());

TypeScript 類型定義


interface FormatDateOptions {
  locale?: 'zh-CN' | 'en-US' | string;
  utc?: boolean;
}

declare function formatDate(date: Date | number | string, format: string, options?: FormatDateOptions): string;
declare function createFormatter(format: string): (date: Date | number | string) => string;
copyright © 萬盛學電腦網 all rights reserved