DIV CSS 佈局教程網

JavaScript 日期處理完整工具箱:Date 內建方法與實用擴充函式
編輯:關於JavaScript     

日期處理是每個專案都會碰到的髒活。原生 Date 提供了基礎的讀取方法,但格式化、閏年判斷、日期相減這些常用操作都得自己刻。本文把內建 API 與一份實用的擴充函式整理在一起,可直接放進你的工具檔。

一、內建 Date 的取用方法

var mydate = new Date();
mydate.getYear();            // 年份後兩位(例如 126,即 1900 起算)
mydate.getFullYear();        // 完整年份(四位數)
mydate.getMonth();           // 月份,0 代表一月(0-11)
mydate.getDate();            // 日(1-31)
mydate.getDay();             // 星期(0-6,0 為週日)
mydate.getTime();            // 自 1970.1.1 起的毫秒數
mydate.getHours();           // 小時(0-23)
mydate.getMinutes();         // 分(0-59)
mydate.getSeconds();         // 秒(0-59)
mydate.getMilliseconds();    // 毫秒(0-999)
mydate.toLocaleDateString(); // 目前日期
mydate.toLocaleTimeString(); // 目前時間
mydate.toLocaleString();     // 日期與時間

最容易踩的兩個坑:月份從 0 開始,以及 getYear() 回傳的是「1900 起算」的偏移值——現代程式請一律改用 getFullYear()。

二、擴充方法總覽

透過 Date.prototype 擴充後,你可以獲得:isLeapYear(判斷閏年)、Format(格式化)、DateAdd(日期加減)、DateDiff(相減求差)、toString(轉字串)、toArray(拆分為陣列)、DatePart(取單一成分)、MaxDayOfDate(當月天數)、WeekNumOfYear(年度第幾週),以及全域的 StringToDate、IsValidDate、CheckDateTime、daysBetween。

三、判斷閏年

Date.prototype.isLeapYear = function () {
    var y = this.getFullYear();
    return (0 == y % 4 && (0 != y % 100 || 0 == y % 400));
};

四、日期格式化 Format

支援 yyyy/YYYY(完整年)、yy/YY(兩位年)、MM/M(月)、w/W(星期)、dd/DD/d/D(日)、hh/HH/h/H(時)、mm/m(分)、ss/SS/s/S(秒)。

Date.prototype.Format = function (formatStr) {
    var str = formatStr;
    var Week = ['日', '一', '二', '三', '四', '五', '六'];

    str = str.replace(/yyyy|YYYY/, this.getFullYear());
    str = str.replace(/yy|YY/, (this.getFullYear() % 100) > 9
        ? (this.getFullYear() % 100).toString()
        : '0' + (this.getFullYear() % 100));
    str = str.replace(/MM/, this.getMonth() + 1 > 9
        ? (this.getMonth() + 1).toString()
        : '0' + (this.getMonth() + 1));
    str = str.replace(/M/g, this.getMonth() + 1);
    str = str.replace(/w|W/g, Week[this.getDay()]);
    str = str.replace(/dd|DD/, this.getDate() > 9
        ? this.getDate().toString() : '0' + this.getDate());
    str = str.replace(/d|D/g, this.getDate());
    str = str.replace(/hh|HH/, this.getHours() > 9
        ? this.getHours().toString() : '0' + this.getHours());
    str = str.replace(/h|H/g, this.getHours());
    str = str.replace(/mm/, this.getMinutes() > 9
        ? this.getMinutes().toString() : '0' + this.getMinutes());
    str = str.replace(/m/g, this.getMinutes());
    str = str.replace(/ss|SS/, this.getSeconds() > 9
        ? this.getSeconds().toString() : '0' + this.getSeconds());
    str = str.replace(/s|S/g, this.getSeconds());

    return str;
};

這裡我修正了原始寫法的月份位移:內建的 getMonth() 回傳 0-11,格式化輸出時必須 +1,否則一月會被印成 00。另外 replace 是逐次呼叫的,因此「先長後短」的順序很重要——若先換掉單字母 M,後面的 MM 就永遠不會命中。

五、日期加減 DateAdd

Date.prototype.DateAdd = function (strInterval, Number) {
    var dtTmp = this;
    switch (strInterval) {
        case 's': return new Date(Date.parse(dtTmp) + (1000 * Number));
        case 'n': return new Date(Date.parse(dtTmp) + (60000 * Number));
        case 'h': return new Date(Date.parse(dtTmp) + (3600000 * Number));
        case 'd': return new Date(Date.parse(dtTmp) + (86400000 * Number));
        case 'w': return new Date(Date.parse(dtTmp) + ((86400000 * 7) * Number));
        case 'q': return new Date(dtTmp.getFullYear(),
                                 dtTmp.getMonth() + Number * 3,
                                 dtTmp.getDate(), dtTmp.getHours(),
                                 dtTmp.getMinutes(), dtTmp.getSeconds());
        case 'm': return new Date(dtTmp.getFullYear(),
                                 dtTmp.getMonth() + Number,
                                 dtTmp.getDate(), dtTmp.getHours(),
                                 dtTmp.getMinutes(), dtTmp.getSeconds());
        case 'y': return new Date(dtTmp.getFullYear() + Number,
                                 dtTmp.getMonth(), dtTmp.getDate(),
                                 dtTmp.getHours(), dtTmp.getMinutes(),
                                 dtTmp.getSeconds());
    }
};

參數 strInterval 分別代表秒、分、時、日、週、季、月、年。月以上的單位直接用 Date 建構子處理,能自動沿日期溢出(例如 1 月 31 日加一個月會得到 3 月 2 或 3 日),這也是為什麼月、年不能單純用毫秒相加。

六、日期相減 DateDiff 與天數差

Date.prototype.DateDiff = function (strInterval, dtEnd) {
    var dtStart = this;
    if (typeof dtEnd == 'string') { dtEnd = StringToDate(dtEnd); }
    switch (strInterval) {
        case 's': return parseInt((dtEnd - dtStart) / 1000);
        case 'n': return parseInt((dtEnd - dtStart) / 60000);
        case 'h': return parseInt((dtEnd - dtStart) / 3600000);
        case 'd': return parseInt((dtEnd - dtStart) / 86400000);
        case 'w': return parseInt((dtEnd - dtStart) / (86400000 * 7));
        case 'm': return (dtEnd.getMonth() + 1)
                       + ((dtEnd.getFullYear() - dtStart.getFullYear()) * 12)
                       - (dtStart.getMonth() + 1);
        case 'y': return dtEnd.getFullYear() - dtStart.getFullYear();
    }
};

若你只需要兩個 YYYY-MM-DD 字串之間相差幾天,這個獨立函式更省事:

function daysBetween(DateOne, DateTwo) {
    var OneMonth = DateOne.substring(5, DateOne.lastIndexOf('-'));
    var OneDay   = DateOne.substring(DateOne.lastIndexOf('-') + 1);
    var OneYear  = DateOne.substring(0, DateOne.indexOf('-'));
    var TwoMonth = DateTwo.substring(5, DateTwo.lastIndexOf('-'));
    var TwoDay   = DateTwo.substring(DateTwo.lastIndexOf('-') + 1);
    var TwoYear  = DateTwo.substring(0, DateTwo.indexOf('-'));
    var cha = (Date.parse(OneMonth + '/' + OneDay + '/' + OneYear)
             - Date.parse(TwoMonth + '/' + TwoDay + '/' + TwoYear)) / 86400000;
    return Math.abs(cha);
}

原始寫法在取「日」時用了 substring(len, lastIndexOf('-')+1),起點大於終點會回傳空字串,導致計算失敗;這裡已改為從最後一個 - 之後取到結尾。

七、重載 toString、轉陣列與取成分

Date.prototype.toString = function (showWeek) {
    var myDate = this;
    var str = myDate.toLocaleDateString();
    if (showWeek) {
        var Week = ['日', '一', '二', '三', '四', '五', '六'];
        str += ' 星期' + Week[myDate.getDay()];
    }
    return str;
};

Date.prototype.toArray = function () {
    var d = this;
    return [d.getFullYear(), d.getMonth(), d.getDate(),
            d.getHours(), d.getMinutes(), d.getSeconds()];
};

Date.prototype.DatePart = function (interval) {
    var d = this;
    var Week = ['日', '一', '二', '三', '四', '五', '六'];
    switch (interval) {
        case 'y':  return d.getFullYear();
        case 'm':  return d.getMonth() + 1;
        case 'd':  return d.getDate();
        case 'w':  return Week[d.getDay()];
        case 'h':  return d.getHours();
        case 'n':  return d.getMinutes();
        case 's':  return d.getSeconds();
    }
};

Date.prototype.MaxDayOfDate = function () {
    // 下個月 1 日減一天,就是本月最後一天
    var d = this;
    return new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();
};

取得「當月最大天數」不必繞一大圈,new Date(year, month + 1, 0) 就是一個乾淨的技巧:日期 0 會被正規化成上一天。關於「年度第幾週」,原稿用了 document.write 輸出 VBScript 的寫法,那在現代瀏覽器完全不會執行,實務上請改用 ISO 8601 的計算方式:

Date.prototype.WeekNumOfYear = function () {
    var d = new Date(Date.UTC(this.getFullYear(), this.getMonth(), this.getDate()));
    var dayNum = d.getUTCDay() || 7;
    d.setUTCDate(d.getUTCDate() + 4 - dayNum);          // 移到該週的星期四
    var yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
    return Math.ceil((((d - yearStart) / 86400000) + 1) / 7);
};

八、字串轉日期與有效性驗證

function StringToDate(DateStr) {
    var converted = Date.parse(DateStr);
    var myDate = new Date(converted);
    if (isNaN(myDate)) {
        var arys = DateStr.split('-');
        myDate = new Date(arys[0], --arys[1], arys[2]);
    }
    return myDate;
}

function IsValidDate(DateStr) {
    var sDate = DateStr.replace(/(^\s+|\s+$)/g, '');   // 去前後空白
    if (sDate == '') { return true; }

    // 若符合 YYYY-MM-DD / YYYY-M-D 等形式,正則替換後應為空字串
    var s = sDate.replace(/[\d]{4,4}[\-/]{1}[\d]{1,2}[\-/]{1}[\d]{1,2}/g, '');
    if (s == '') {
        var t = new Date(sDate.replace(/\-/g, '/'));
        var ar = sDate.split(/[-\/]/);
        // 逐欄比對,可攔下 2 月 30 日這類「格式正確但日期不存在」的輸入
        if (ar[0] != t.getFullYear() || ar[1] != t.getMonth() + 1 || ar[2] != t.getDate()) {
            return false;
        }
    } else {
        return false;
    }
    return true;
}

function CheckDateTime(str) {
    var reg = /^(\d+)-(\d{1,2})-(\d{1,2}) (\d{1,2}):(\d{1,2}):(\d{1,2})$/;
    var r = str.match(reg);
    if (r == null) { return false; }
    r[2] = r[2] - 1;
    var d = new Date(r[1], r[2], r[3], r[4], r[5], r[6]);
    return d.getFullYear() == r[1] && d.getMonth() == r[2] && d.getDate() == r[3]
        && d.getHours() == r[4] && d.getMinutes() == r[5] && d.getSeconds() == r[6];
}

IsValidDate 的核心價值在「回頭比對」:JS 會把 2 月 30 日自動正規化成 3 月 2 日,只有把年月日拆出來跟原字串逐欄對照,才能真正判斷使用者輸入的日期存不存在——閏年 2 月 29 日也因此在同一套邏輯裡被正確處理。

實務建議

擴充 Date.prototype 雖然方便,但在多人協作或引入第三方函式庫時,容易與其他人的擴充或未來的標準方法衝突。新專案我會建議改用 dayjs 或 date-fns 這類不可變(immutable)的函式庫,把格式化、加減、比較都寫成純函式,除錯與測試都更輕鬆。若只是維護老系統,上面這份工具箱依然堪用,只要記住我已修正的三處:月份 +1、daysBetween 取日的起點、以及年度週數改用 UTC 計算。

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