萬盛學電腦網

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

JavaScript 中文日期顯示:每日自動更新的農曆/數字日期組件

原版代碼分析

原文使用 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、硬編碼年份、秒級輪詢等反模式。

copyright © 萬盛學電腦網 all rights reserved