1. 程式人生 > >JS版日期格式化和解析工具類,毫秒級

JS版日期格式化和解析工具類,毫秒級

/**
 * =====================================
 *               日期相關方法
 * =====================================
 */
;(function($)
{
    $.extend(
    {
        /**
         * 將日期格式化成指定格式的字串
         * @param date 要格式化的日期,不傳時預設當前時間,也可以是一個時間戳
         * @param fmt 目標字串格式,支援的字元有:y,M,d,q,w,H,h,m,S,預設:yyyy-MM-dd HH:mm:ss
         * @returns 返回格式化後的日期字串
         */
        formatDate: function(date, fmt)
        {
            date = date == undefined ? new Date() : date;
            date = typeof date == 'number' ? new Date(date) : date;
            fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
            var obj =
            {
                'y': date.getFullYear(), // 年份,注意必須用getFullYear
                'M': date.getMonth() + 1, // 月份,注意是從0-11
                'd': date.getDate(), // 日期
                'q': Math.floor((date.getMonth() + 3) / 3), // 季度
                'w': date.getDay(), // 星期,注意是0-6
                'H': date.getHours(), // 24小時制
                'h': date.getHours() % 12 == 0 ? 12 : date.getHours() % 12, // 12小時制
                'm': date.getMinutes(), // 分鐘
                's': date.getSeconds(), // 秒
                'S': date.getMilliseconds() // 毫秒
            };
            var week = ['天', '一', '二', '三', '四', '五', '六'];
            for(var i in obj)
            {
                fmt = fmt.replace(new RegExp(i+'+', 'g'), function(m)
                {
                    var val = obj[i] + '';
                    if(i == 'w') return (m.length > 2 ? '星期' : '周') + week[val];
                    for(var j = 0, len = val.length; j < m.length - len; j++) val = '0' + val;
                    return m.length == 1 ? val : val.substring(val.length - m.length);
                });
            }
            return fmt;
        },
        /**
         * 將字串解析成日期
         * @param str 輸入的日期字串,如'2014-09-13'
         * @param fmt 字串格式,預設'yyyy-MM-dd',支援如下:y、M、d、H、m、s、S,不支援w和q
         * @returns 解析後的Date型別日期
         */
        parseDate: function(str, fmt)
        {
            fmt = fmt || 'yyyy-MM-dd';
            var obj = {y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0};
            fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function(m, $1, $2, $3, $4, idx, old)
            {
                str = str.replace(new RegExp($1+'(\\d{'+$2.length+'})'+$4), function(_m, _$1)
                {
                    obj[$3] = parseInt(_$1);
                    return '';
                });
                return '';
            });
            obj.M--; // 月份是從0開始的,所以要減去1
            var date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
            if(obj.S !== 0) date.setMilliseconds(obj.S); // 如果設定了毫秒
            return date;
        },
        /**
         * 將一個日期格式化成友好格式,比如,1分鐘以內的返回“剛剛”,
         * 當天的返回時分,當年的返回月日,否則,返回年月日
         * @param {Object} date
         */
        formatDateToFriendly: function(date)
        {
            date = date || new Date();
            date = typeof date === 'number' ? new Date(date) : date;
            var now = new Date();
            if((now.getTime() - date.getTime()) < 60*1000) return '剛剛'; // 1分鐘以內視作“剛剛”
            var temp = this.formatDate(date, 'yyyy年M月d');
            if(temp == this.formatDate(now, 'yyyy年M月d')) return this.formatDate(date, 'HH:mm');
            if(date.getFullYear() == now.getFullYear()) return this.formatDate(date, 'M月d日');
            return temp;
        },
        /**
         * 將一段時長轉換成友好格式,如:
         * 147->“2分27秒”
         * 1581->“26分21秒”
         * 15818->“4小時24分”
         * @param {Object} second
         */
        formatDurationToFriendly: function(second)
        {
            if(second < 60) return second + '秒';
            else if(second < 60*60) return (second-second%60)/60+'分'+second%60+'秒';
            else if(second < 60*60*24) return (second-second%3600)/60/60+'小時'+Math.round(second%3600/60)+'分';
            return (second/60/60/24).toFixed(1)+'天';
        },
        /** 
         * 將時間轉換成MM:SS形式 
         */
        formatTimeToFriendly: function(second)
        {
            var m = Math.floor(second / 60);
            m = m < 10 ? ( '0' + m ) : m;
            var s = second % 60;
            s = s < 10 ? ( '0' + s ) : s;
            return m + ':' + s;
        },
        /**
         * 判斷某一年是否是閏年
         * @param year 可以是一個date型別,也可以是一個int型別的年份,不傳預設當前時間
         */
        isLeapYear: function(year)
        {
            if(year === undefined) year = new Date();
            if(year instanceof Date) year = year.getFullYear();
            return (year % 4 == 0 && year % 100 != 0) || (year % 400 == 0);
        },
        /**
         * 獲取某一年某一月的總天數,沒有任何引數時獲取當前月份的
         * 方式一:$.getMonthDays();
         * 方式二:$.getMonthDays(new Date());
         * 方式三:$.getMonthDays(2013, 12);
         */
        getMonthDays: function(date, month)
        {
            var y, m;
            if(date == undefined) date = new Date();
            if(date instanceof Date)
            {
                y = date.getFullYear();
                m = date.getMonth();
            }
            else if(typeof date == 'number')
            {
                y = date;
                m = month-1;
            }
            var days = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; // 非閏年的一年中每個月份的天數
            //如果是閏年並且是2月
            if(m == 1 && this.isLeapYear(y)) return days[m]+1;
            return days[m];
        },
        /**
         * 計算2日期之間的天數,用的是比較毫秒數的方法
         * 傳進來的日期要麼是Date型別,要麼是yyyy-MM-dd格式的字串日期
         * @param date1 日期一
         * @param date2 日期二
         */
        countDays: function(date1, date2)
        {
            var fmt = 'yyyy-MM-dd';
            // 將日期轉換成字串,轉換的目的是去除“時、分、秒”
            if(date1 instanceof Date && date2 instanceof Date)
            {
                date1 = this.format(fmt, date1);
                date2 = this.format(fmt, date2);
            }
            if(typeof date1 === 'string' && typeof date2 === 'string')
            {
                date1 = this.parse(date1, fmt);
                date2 = this.parse(date2, fmt);
                return (date1.getTime() - date2.getTime()) / (1000*60*60*24);
            }
            else
            {
                console.error('引數格式無效!');
                return 0;
            }
        }
    });
})(jQuery);