DIV CSS 佈局教程網

用 fecha 搞定 JS 日期處理:格式化、解析與二次封裝
編輯:關於JavaScript     

前言

項目中我們選用 fecha 做日期處理,並在其基礎上做了一層封裝,以滿足實際業務需求。

fecha 是什麼

fecha 是一個日期格式化與解析的 JS 庫,功能強大卻只有 2k 體積。安裝很簡單:

npm install fecha --save

Formatting:日期格式化

核心方法是 fecha.format,接收一個 Date 對象(或時間戳)與一個字符串形式的日期格式,返回格式化後的字符串。

注意:傳入無效參數時,fecha 會拋出錯誤。

fecha.format(<Date Object>, <String Format>);

//自定義格式化
fecha.format(new Date(2015, 10, 20), 'dddd MMMM Do, YYYY');
//'Friday November 20th, 2015'
fecha.format(new Date(1998, 5, 3, 15, 23, 10, 350), 'YYYY-MM-DD hh:mm:ss.SSS A');
//'1998-06-03 03:23:10.350 PM'

//使用預設常量
fecha.format(new Date(2015, 10, 20), 'mediumDate');   //'Nov 20, 2015'
fecha.format(new Date(2015, 2, 10, 5, 30, 20), 'shortTime');  //'05:30'

//方括號內的內容會原樣輸出
fecha.format(new Date(2001, 2, 5, 6, 7, 2, 5), '[on] MM-DD-YYYY [at] HH:mm');
//'on 03-05-2001 at 06:07'

有了方括號這個技巧,new Date() 轉成「2016年11月19日」就變得非常直觀:

fecha.format(new Date(), 'YYYY[年]MM[月]DD[日]')

Parsing:日期解析

fecha.parse 與 format 相對,接收一個日期字符串與格式模板,返回 Date 對象。同樣地,參數無效時會報錯。

fecha.parse('February 3rd, 2014', 'MMMM Do, YYYY');  //new Date(2014, 1, 3)
fecha.parse('10-12-10 14:11:12', 'YY-MM-DD HH:mm:ss');
//new Date(2010, 11, 10, 14, 11, 12)

//使用預設常量
fecha.parse('5/3/98', 'shortDate');            //new Date(1998, 4, 3)
fecha.parse('November 4, 2005', 'longDate');   //new Date(2005, 10, 4)

自定義命名常量

把常用格式命名成常量,可以少寫很多重複的格式串:

fecha.masks = {
    'default': 'ddd MMM DD YYYY',
    shortDate: 'M/D/YY',
    mediumDate: 'MMM D, YYYY',
    longDate: 'MMMM D, YYYY',
    fullDate: 'dddd, MMMM D, YYYY',
    shortTime: 'HH:mm',
    mediumTime: 'HH:mm:ss',
    longTime: 'HH:mm:ss.SSS'
};

國際化支持

實際業務裡經常會遇到很「本土化」的需求:把週一顯示成「星期一」,甚至改成「月曜日」、「火曜日」這種寫法。這些都可以透過 fecha 的 i18n 配置實現。

fecha.i18n = {
    dayNamesShort: ['周日', '周一', '周二', '周三', '周四', '周五', '周六'],
    dayNames: ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'],
    monthNamesShort: ['01', '02', '03', '04', '05', '06', '07', '08', '09', '10', '11', '12'],
    monthNames: ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'],
    amPm: ['上午', '下午'],
    //D 是月份中的第幾天,這個函數返回 3rd、11th 這類序數後綴
    DoFn: function (D) {
        return D + ['th', 'st', 'nd', 'rd'][D % 10 > 3 ? 0 : (D - D % 10 !== 10) * D % 10];
    }
}

完整的格式化占位符對照表如下:

為什麼還要再封裝一層

真實需求往往更瑣碎:

2016-11-20 → 明天 11-20
2016-11-23 → 下周三 11-23 10:00
10:00 加上 100 分鐘之後的時間
...

雖然 fecha 已經提供了實用的日期能力,但面對千奇百怪的業務規則,仍然需要再封裝一層。這麼做有兩個好處:一是把 i18n 與 masks 的配置抽到公共組件裡,避免多個頁面重複設置;二是頁面調用時更簡潔。

封裝示例

import fecha from 'fecha'

fecha.i18n = {
    dayNamesShort: ['周日', '周一', '周二', '周三', '周四', '周五', '周六'],
    dayNames: ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'],
    monthNamesShort: ['01', '02', '03', '04', '05', '06', '07', '08', '09', '10', '11', '12'],
    monthNames: ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'],
    amPm: ['上午', '下午'],
    DoFn: function (D) {
        return D + ['th', 'st', 'nd', 'rd'][D % 10 > 3 ? 0 : (D - D % 10 !== 10) * D % 10];
    }
}

fecha.masks = {
    'default': 'ddd MMM DD YYYY',
    shortDate: 'M/D/YY',
    mediumDate: 'MMM D, YYYY',
    longDate: 'MMMM D, YYYY',
    fullDate: 'dddd, MMMM D, YYYY',
    shortTime: 'HH:mm',
    mediumTime: 'HH:mm:ss',
    longTime: 'HH:mm:ss.SSS'
}

// str 必須是 YYYYMMDD 格式
// YYYYMMDD → 今天 / 明天 / 後天 / 下周一 …… 這樣的友好文案
fecha.getDateString = (str, format) => {
    let now = Date.now();
    let today = fecha.format.bind(null, new Date());
    let tomorrow = fecha.format.bind(null, new Date(now + 86400 * 1000));
    let dayafter = fecha.format.bind(null, new Date(now + 86400 * 2 * 1000));
    let week_start = parseInt(today('d'));
    let result = {};
    //從本周一到下周日,共 14 天
    let weeks = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];

    result[today(YYYYMMDD)] = `今天 ${today('MM')}月${today('DD')}日`;
    result[tomorrow(YYYYMMDD)] = `明天 ${tomorrow('MM')}月${tomorrow('DD')}日`;
    result[dayafter(YYYYMMDD)] = `後天 ${dayafter('MM')}月${dayafter('DD')}日`;

    weeks.slice(week_start + 3).forEach((after) => {
        let step = after - week_start;
        let _dayafter = fecha.format.bind(null, new Date(now + 86400 * step * 1000));
        result[_dayafter(YYYYMMDD)] = `${(after < 8 ? '本' : '下')}${_dayafter('ddd')} ${_dayafter('MM')}-${_dayafter('DD')}`;
    });

    //如果超出範圍(例如出現「下下周一」),則按傳入的格式規範直接輸出
    return result || format(fecha.parse(str, YYYYMMDD), format);
}

export default fecha

其他頁面需要處理日期時,直接引用這個組件即可:

import DateParser from 'fecha'

let date = DateParser.getDateString('20161123', 'YYYY-MM-DD')

當現有能力仍不足以應付需求時,只需在 fecha 組件中自行追加方法並寫好註釋,後續同事遇到相同場景就能直接調用,團隊效率自然也就上來了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved