原生 Date 僅提供 toString/toISOString/toLocaleString 等固定格式,無法自定義如 yyyy-MM-dd HH:mm:ss、yyyy年MM月dd日 等業務格式。
getFullYear(), getMonth() (0-11), getDate(), getHours(), getMinutes(), getSeconds(), getMilliseconds(), getDay() (0-6 周日-周六)yyyy, MM, dd 等)M→9, MM→09)/**
* 日期格式化
* @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 時間
// 僅開發環境/內部項目使用,避免污染全局原型
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 | ~2KB | API 兼容 Moment.js、不可變、插件化、國際化 | 遷移 Moment 項目、體積敏感 |
| Moment.js | ~16KB (含 locale 更大) | 功能最全、可變對象、停止維護 | 維護老項目 |
| Luxon | ~12KB | 基於 Intl API、不可變、時區支持強 | 複雜時區業務 |
| 原生 Intl.DateTimeFormat | 0KB | 瀏覽器內置、無依賴、性能最強 | 簡單本地化格式化 |
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"