分享自己写的JS版日期格式化和解析工具类,绝对好用!

分享自己写的JS版日期格式化和解析工具类,绝对好用!

原文链接

日期格式化

2.1. 使用说明

formatDate(date, fmt),其中fmt支持的格式有:

  • y(年)
  • M(月)
  • d(日)
  • q(季度)
  • w(星期)
  • H(24小时制的小时)
  • h(12小时制的小时)
  • m(分钟)
  • s(秒)
  • S(毫秒)

另外,字符的个数决定输出字符的长度,如,yy输出16,yyyy输出2016,ww输出周五,www输出星期五,等等。

2.2. 代码

完整代码一共30行:

/**
 * 将日期格式化成指定格式的字符串
 * @param date 要格式化的日期,不传时默认当前时间,也可以是一个时间戳
 * @param fmt 目标字符串格式,支持的字符有:y,M,d,q,w,H,h,m,S,默认:yyyy-MM-dd HH:mm:ss
 * @returns 返回格式化后的日期字符串
 */
function formatDate(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;
}

2.3. 使用示例

formatDate(); // 2016-09-02 13:17:13
formatDate(new Date(), "yyyy-MM-dd"); // 2016-09-02
// 2016-09-02 第3季度 星期五 13:19:15:792
formatDate(new Date(), "yyyy-MM-dd 第q季度 www HH:mm:ss:SSS");
formatDate(1472793615764); // 2016-09-02 13:20:15

日期解析

3.1. 说明

parseDate(str, fmt),其中fmt支持的格式有:

  • y(年)
  • M(月)
  • d(日)
  • H(24小时制的小时)
  • h(12小时制的小时)
  • m(分钟)
  • s(秒)
  • S(毫秒)

3.2. 完整代码

完整代码共17行:

/**
 * 将字符串解析成日期
 * @param str 输入的日期字符串,如"2014-09-13"
 * @param fmt 字符串格式,默认"yyyy-MM-dd",支持如下:y、M、d、H、m、s、S,不支持w和q
 * @returns 解析后的Date类型日期
 */
function parseDate(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;
}

3.3. 示例代码

parseDate("2016-08-11"); // Thu Aug 11 2016 00:00:00 GMT+0800
parseDate("2016-08-11 13:28:43", "yyyy-MM-dd HH:mm:ss") // Thu Aug 11 2016 13:28:43 GMT+0800

其它日期相关方法

其它自己还简单封装了几个方法,这里干脆一起贴出来了,包括上面的:

/**
 * =====================================
 *               日期相关方法
 * =====================================
 */
;(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);
个人网站: https://haoji.me
github: https://github.com/sxei
博客园: http://www.cnblogs.com/liuxianan
copyright ©2012-2020 小茗同学