萬盛學電腦網

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

JavaScript 日期時間格式化完全指南:五種主流方案深度解析

前言

日期時間格式化是前端開發的高頻需求。JavaScript 原生 Date 對象 API 較為基礎,缺乏靈活的格式化輸出。本文系統梳理五種主流方案,從原生 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 系列在不同瀏覽器/語言環境下輸出差異極大,不可用於需要統一格式的業務。

方案三:Date.prototype 擴展格式化函數(推薦:靈活、擴展性強)

採用正則替換模板字符,支持 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;

方案五:第三方庫(複雜業務首選)

庫體積特點適用場景
dayjs2KBAPI 與 Moment.js 幾乎一致,不可變、鏈式調用、插件化現代項目首選,替代 Moment
date-fns按需引入函數式、純淨、Tree-shaking 友好函數式編程偏好項目
Moment.js16KB+功能最全、但可變對象、停止維護老項目維護、極複雜時區處理
Luxon12KB基於 Intl API、原生時區支持、不可變需處理多時區、國際化業務

dayjs 實戰示例

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天后日期

最佳實踐總結

  1. 輕量級項目/無構建工具:方案三(原型擴展)或方案四(工具函數)
  2. 現代構建項目:dayjs(體積小、API 熟悉、生態完善)
  3. 重時區/國際化業務:Luxon 或 date-fns-tz
  4. 避坑指南:
    • 切勿直接修改 Date.prototype 於共享庫中(污染全局)
    • 警惕 new Date('2024-03-15') 在 Safari 中解析為 UTC 導致日期偏移,統一使用 new Date(2024, 2, 15) 或 dayjs 解析
    • 存儲傳輸統一用 ISO 8601 / 時間戳,展示層再格式化

結語

日期格式化看似簡單,實則涉及時區、本地化、性能、維護性等多維考量。建議團隊統一規範:業務層使用 dayjs,工具庫封裝通用格式常量,禁止分散式手寫格式化邏輯。如此既保證一致性,又便於未來遷移升級。

copyright © 萬盛學電腦網 all rights reserved