日期時間格式化是前端開發的高頻需求。JavaScript 原生 Date 對象 API 較為基礎,缺乏靈活的格式化輸出。本文系統梳理五種主流方案,從原生 API 到原型擴展、第三方庫,助你根據項目場景選擇最佳實踐。
function formatDateNative(date) {
var week = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
var y = date.getFullYear();
var m = String(date.getMonth() + 1).padStart(2, '0');
var d = String(date.getDate()).padStart(2, '0');
var h = String(date.getHours()).padStart(2, '0');
var min = String(date.getMinutes()).padStart(2, '0');
var s = String(date.getSeconds()).padStart(2, '0');
return `${y}年${m}月${d}日 ${h}:${min}:${s} ${week[date.getDay()]}`;
}
// 使用
console.log(formatDateNative(new Date()));
// 2024年03月15日 14:30:05 星期五
優點:無依賴、體積極小、完全可控
缺點:代碼冗長、維護成本高、無時區/本地化支持
| 方法 | 輸出示例 | 說明 |
|---|---|---|
toString() | "Fri Mar 15 2024 14:30:05 GMT+0800" | 完整時間字符串 |
toDateString() | "Fri Mar 15 2024" | 僅日期部分 |
toTimeString() | "14:30:05 GMT+0800" | 僅時間部分 |
toLocaleDateString() | "2024/3/15" 或 "2024年3月15日" | 按瀏覽器語言環境格式化日期 |
toLocaleTimeString() | "下午2:30:05" | 按語言環境格式化時間 |
toISOString() | "2024-03-15T06:30:05.000Z" | ISO 8601 標準,UTC 時間 |
toUTCString() | "Fri, 15 Mar 2024 06:30:05 GMT" | UTC 時間字符串 |
注意:toLocaleString 系列在不同瀏覽器/語言環境下輸出差異極大,不可用於需要統一格式的業務。
採用正則替換模板字符,支持 yyyy/MM/dd hh:mm:ss 等任意格式:
Date.prototype.format = function(fmt) {
var o = {
'M+': this.getMonth() + 1, // 月份
'd+': this.getDate(), // 日
'h+': this.getHours(), // 小時(12制)
'H+': this.getHours(), // 小時(24制)
'm+': this.getMinutes(), // 分
's+': this.getSeconds(), // 秒
'q+': Math.floor((this.getMonth() + 3) / 3), // 季度
'S': this.getMilliseconds() // 毫秒
};
var week = ['日', '一', '二', '三', '四', '五', '六'];
if (/(y+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, (this.getFullYear() + '').substr(4 - RegExp.$1.length));
}
if (/(E+)/.test(fmt)) {
fmt = fmt.replace(RegExp.$1, RegExp.$1.length > 1 ?
(RegExp.$1.length > 2 ? '星期' : '週') + week[this.getDay()] : week[this.getDay()]);
}
for (var k in o) {
if (new RegExp('(' + k + ')').test(fmt)) {
fmt = fmt.replace(RegExp.$1, RegExp.$1.length === 1 ? o[k] :
('00' + o[k]).substr(('' + o[k]).length));
}
}
return fmt;
};
// 使用示例
var now = new Date();
console.log(now.format('yyyy-MM-dd HH:mm:ss')); // 2024-03-15 14:30:05
console.log(now.format('yyyy年M月d日 EEEE')); // 2024年3月15日 星期五
console.log(now.format('HH:mm:ss.S')); // 14:30:05.123
const dateUtils = {
format: function(date, fmt) {
if (!(date instanceof Date)) date = new Date(date);
// 同方案三核心邏輯...
return fmt; // 返回格式化字符串
},
parse: function(str, fmt) {
// 反向解析:將格式化字符串轉回 Date 對象
// 需配合正則提取年月日時分秒
},
// 常用快捷方法
today: function(fmt) { return this.format(new Date(), fmt || 'yyyy-MM-dd'); },
now: function(fmt) { return this.format(new Date(), fmt || 'yyyy-MM-dd HH:mm:ss'); },
timestamp: function() { return Date.now(); }
};
// ES Module 導出
export default dateUtils;
| 庫 | 體積 | 特點 | 適用場景 |
|---|---|---|---|
| dayjs | 2KB | API 與 Moment.js 幾乎一致,不可變、鏈式調用、插件化 | 現代項目首選,替代 Moment |
| date-fns | 按需引入 | 函數式、純淨、Tree-shaking 友好 | 函數式編程偏好項目 |
| Moment.js | 16KB+ | 功能最全、但可變對象、停止維護 | 老項目維護、極複雜時區處理 |
| Luxon | 12KB | 基於 Intl API、原生時區支持、不可變 | 需處理多時區、國際化業務 |
import dayjs from 'dayjs';
import 'dayjs/locale/zh-cn'; // 按需引入語言包
import relativeTime from 'dayjs/plugin/relativeTime';
import advancedFormat from 'dayjs/plugin/advancedFormat';
dayjs.extend(relativeTime);
dayjs.extend(advancedFormat);
dayjs.locale('zh-cn');
console.log(dayjs().format('YYYY年MM月DD日 dddd')); // 2024年03月15日 星期五
console.log(dayjs('2024-01-01').fromNow()); // 2個月前
console.log(dayjs().add(3, 'day').format('YYYY-MM-DD')); // 3天后日期
Date.prototype 於共享庫中(污染全局)new Date('2024-03-15') 在 Safari 中解析為 UTC 導致日期偏移,統一使用 new Date(2024, 2, 15) 或 dayjs 解析日期格式化看似簡單,實則涉及時區、本地化、性能、維護性等多維考量。建議團隊統一規範:業務層使用 dayjs,工具庫封裝通用格式常量,禁止分散式手寫格式化邏輯。如此既保證一致性,又便於未來遷移升級。