原文使用 document.write 直接輸出,邏輯混雜在腳本中,使用 number() 函數將阿拉伯數字轉中文數字(一、二、三...十、十一...二十、二十一...三十、三十一),硬編碼年份「2007年」。
/**
* 中文日期顯示組件
* 支持:公曆中文、星期、可選農曆、自動更新、多格式
*/
class ChineseDateDisplay {
constructor(container, options = {}) {
this.container = typeof container === 'string' ? document.querySelector(container) : container;
this.options = {
showLunar: false, // 是否顯示農曆
format: 'YYYY年MM月DD日 dddd', // 顯示格式
interval: 1000 * 60, // 更新間隔:默認 1 分鐘(日期級變化無需秒級)
locale: 'zh-CN',
...options
};
this.timer = null;
this._init();
}
_init() {
if (!this.container) return;
this._render();
// 每分鐘檢查一次日期是否變化(跨天更新)
this.timer = setInterval(() => this._render(), this.options.interval);
// 頁面可見時立即同步
document.addEventListener('visibilitychange', () => {
if (!document.hidden) this._render();
});
}
_render() {
const now = new Date();
const formatted = this._formatDate(now);
// 僅內容變化時更新(避免重繪)
if (this.container.textContent !== formatted) {
this.container.textContent = formatted;
}
}
_formatDate(date) {
const opt = this.options;
const year = date.getFullYear();
const month = date.getMonth() + 1;
const day = date.getDate();
const week = ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'][date.getDay()];
// 中文數字轉換
const toChineseNum = (num) => {
const chinese = '零一二三四五六七八九';
const units = ['','十','百','千'];
if (num === 0) return '零';
let str = '';
let pos = 0;
while (num > 0) {
const digit = num % 10;
if (digit !== 0) {
str = chinese[digit] + units[pos] + str;
} else if (str && str[0] !== '零') {
str = '零' + str;
}
num = Math.floor(num / 10);
pos++;
}
// 特殊處理 10-19
if (str === '一十') return '十';
if (str.startsWith('一十')) return str.slice(1);
return str.replace(/零+$/,'').replace(/零+/g,'零');
};
const cYear = String(year).split('').map(d => '零一二三四五六七八九'[d]).join('');
const cMonth = toChineseNum(month);
const cDay = toChineseNum(day);
let result = opt.format
.replace('YYYY', cYear)
.replace('MM', cMonth)
.replace('DD', cDay)
.replace('dddd', week);
// 可選:農曆(需引入農曆庫,如 @mikefeng/lunar 或自帶簡易算法)
if (opt.showLunar) {
// 此處略過複雜農曆算法,建議引入成熟庫
result += ' (農曆...)';
}
return result;
}
destroy() {
clearInterval(this.timer);
this.container = null;
}
}
// 使用
document.addEventListener('DOMContentLoaded', () => {
// 自動掛載:
document.querySelectorAll('[data-chinese-date]').forEach(el => {
new ChineseDateDisplay(el, { format: el.dataset.chineseDate || 'YYYY年MM月DD日 dddd' });
});
});
HTML 接入
關鍵改進點
項目 原版 現代版
輸出方式 document.write (阻塞、不可控)textContent 安全、可隨時更新
年份 硬編碼 "2007年" getFullYear() 動態獲取
中文數字 僅支持 1-31,硬編碼邏輯 通用 toChineseNum 支持任意正整數
更新頻率 秒級 setTimeout 遞歸 分鐘級 setInterval + 可見性優化
組件化 無,代碼耦合在頁面 Class 封裝、可多實例、可銷毀
擴展性 無 支持格式模板、農曆擴展、國際化
農曆支持方案
純 JS 實現農曆算法較複雜(涉及閏月、節氣、冬至點計算),生產環境建議引入成熟庫:
// npm i @mikefeng/lunar
import { Lunar } from '@mikefeng/lunar';
const lunar = Lunar.fromDate(new Date());
console.log(lunar.toString()); // "二零二四年甲辰龍年 三月廿三"
或輕量級:lunar-javascript (2KB gzipped)。
總結
中文日期顯示看似簡單,實則涉及**數字中文化算法、日期格式化、定時器管理、組件生命周期**。封裝為 ChineseDateDisplay 類,支持模板格式、自動更新、可見性優化、農曆擴展接口,即得生產級可復用組件。棄用 document.write、硬編碼年份、秒級輪詢等反模式。
- 上一篇程序編程: JS 經典特效:建設銀行風格虛擬鍵盤密碼輸入器
- 下一篇程序編程: JavaScript 實現複製/剪切到剪貼板:現代 API 與降級方案