『开源』扩展 JS 的 Date 处理函数
背景：
JS 有自己的 时间类型 Date —— 但是，在某些情况下 这个对象似乎 不太好用。
本文 基于 JQuery 扩展了一些 JS日期函数，包括：
> 字符串 转 Date 对象 万能函数（性能仅 10W次/s，函数有路径优化，字符串越诡异 耗时越长）
> Date 转 字符串 格式化
> 两个 Date 的差值 （返回的结果类似 C# TimeSpan 对象）
一言不合，直接上代码：
1 /*感谢 InkFx (C) http://www.ink-fx.com 为 以下日期函数 作出的努力 */ 2 jQuery = window.jQuery || { }; 3 4 (function($) { 5 6 7 /*--数据类型转换函数 Start----------------------------------*/ 8 9 $.isArray = function(obj) {var result = false;try {result = Object.prototype.toString.apply(obj) === '[object Array]';if (result) return true;} catch(e) {}try {result = obj.constructor === Array;if (result) return true;} catch(e) {}return false;}; 10 $.toInt = function(obj, dft) {try {dft = (typeof dft === 'number') ? dft : 0;} catch(e) {dft = 0;}try {if (obj == null) return dft;if (typeof obj === 'number') return parseInt(obj);var match = obj.toString().toLowerCase().match(/-*[0123456789abcdefx.]+/);var str = match == null || match.length <= 0 ? null : match[0];var result = null;if (str != null && str.length >= 2 && str.substr(0, 2) == "0x") {str = str.substr(2);result = parseInt(str, 16);} else {result = parseInt(str);}if (result == null || !isFinite(result)) return dft;return result;} catch(e) {return dft;}}; 11 $.toFloat = function(obj, dft) {try {dft = (typeof dft === 'number') ? dft : 0;} catch(e) {dft = 0;}try {if (obj == null) return dft;if (typeof obj === 'number') return parseFloat(obj);var match = obj.toString().toLowerCase().match(/-*[0123456789abcdefx.]+/);var str = match == null || match.length <= 0 ? null : match[0];var result = null;if (str != null && str.length >= 2 && str.substr(0, 2) == "0x") {str = str.substr(2);result = parseFloat(parseInt(str, 16));} else {result = parseFloat(str);}if (result == null || !isFinite(result)) return dft;return result;} catch(e) {return dft;}}; 12 $.toString = function(obj, dft) {try {dft = (typeof dft === 'string') ? dft : '';} catch(e) {dft = '';}try {if (obj == null) return dft;if (typeof obj === 'string') return obj;return obj.toString();} catch(e) {return dft;}}; 13 $.toDateTime = function(obj, dft) {try {dft = (dft instanceof Date) ? dft : new Date(1900, 00, 01);} catch(e) {dft = new Date(1900, 00, 01);}try {if (obj == null) return dft;if (obj instanceof Date) return obj;var result = parseDate(obj);if (result == null) return dft;return result;} catch(e) {return dft;}}; 14 $.toBoolean = function(obj, dft) {try {dft = (typeof dft === 'boolean') ? dft : false;} catch(e) {dft = false;}try {if (obj == null) return dft;if (obj == true) return true;if (obj == false) return false;if ($.isArray(obj)) return obj.length >= 1;if (typeof obj === 'boolean') return obj.toString().toLowerCase() == "true";if (typeof obj === 'number') return parseFloat(obj) > 0;/*if (typeof obj === 'string') return parseFloat(obj) > 0;*/if (obj.toString().toLowerCase() == "t") return true;if (obj.toString().toLowerCase() == "true") return true;return false;} catch(e) {return dft;}}; 15 16 17 /*--数据类型转换函数 End------------------------------------*/ 18 19 20 21 /*--时间相关函数 Start--------------------------------------*/ 22 23 $.formatDate = function(date, fmt) {try {date = $.toDateTime(date);fmt = fmt || "yyyy-MM-dd HH:mm:ss"; o = {"M+": date.getMonth() + 1,"d+": date.getDate(),"H+": date.getHours(),"h+": date.getHours() /*(date.getHours() > 12 ? (date.getHours() - 12) : date.getHours())*/,"m+": date.getMinutes(),"s+": date.getSeconds(),"q+": Math.floor((date.getMonth() + 3) / 3),"S": date.getMilliseconds(),"f+": date.getMilliseconds()};if (/(y+)/.test(fmt)) fmt = fmt.replace(RegExp.$1, (date.getFullYear() + "").substr(4 - RegExp.$1.length));for (var k in o)if (new RegExp("(" + k + ")").test(fmt)) {var padLeft = (k == "S" || k == "f+") ? "000" : "00";fmt = fmt.replace(RegExp.$1, RegExp.$1.length == 1 ? o[k] : (padLeft + o[k]).substr(("" + o[k]).length));}return fmt;} catch(e) { return ""; }}; 24 $.isLeapYearDate = function(date) {try {date = $.toDateTime(date);return (0 == date.getFullYear() % 4 && ((date.getFullYear() % 100 != 0) || (date.getFullYear() % 400 == 0)));} catch(e) {return false;}}; 25 26 $.addYears = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var year = date.getFullYear();var month = date.getMonth();var day = date.getDate();var hour = date.getHours();var minute = date.getMinutes();var second = date.getSeconds();var millisecond = date.getMilliseconds();var result = new Date(year + num, month, day, hour, minute, second, millisecond);return result;} catch(e) { return new Date(1900, 01, 01); }}; 27 $.addMonths = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var year = date.getFullYear();var month = date.getMonth();var day = date.getDate();var hour = date.getHours();var minute = date.getMinutes();var second = date.getSeconds();var millisecond = date.getMilliseconds();var addYear = (num + month) / 12;month = (num + month) % 12;var result = new Date(year + addYear, month, day, hour, minute, second, millisecond);return result;} catch(e) { return new Date(1900, 01, 01); }}; 28 $.addDays = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var result = new Date(date.valueOf() + (num * 1000 * 60 * 60 * 24));return result;} catch(e) { return new Date(1900, 01, 01); }}; 29 $.addHours = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var result = new Date(date.valueOf() + (num * 1000 * 60 * 60));return result;} catch(e) { return new Date(1900, 01, 01); }}; 30 $.addMinutes = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var result = new Date(date.valueOf() + (num * 1000 * 60));return result;} catch(e) { return new Date(1900, 01, 01); }}; 31 $.addSeconds = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var result = new Date(date.valueOf() + (num * 1000));return result;} catch(e) { return new Date(1900, 01, 01); }}; 32 $.addMilliseconds = function(date, num) {try {date = $.toDateTime(date);num = $.toInt(num);var result = new Date(date.valueOf() + num);return result;} catch(e) { return new Date(1900, 01, 01); }}; 33 $.getTimeSpan = function(date1, date2) {var timestamp = 0;if((date1 instanceof Date || date2 instanceof Date || date2 == null) || (date1 != null && date2 != null)) {date1 = $.toDateTime(date1);date2 = $.toDateTime(date2);timestamp = $.toFloat(date1 - date2);} else {timestamp = $.toInt(date1);}var temp = $.toInt(timestamp / 1000);var totalMilliSecond = timestamp;var totalSecond = timestamp / (1000);var totalMinute = timestamp / (1000 * 60);var totalHour = timestamp / (1000 * 60 * 60);var totalDay = timestamp / (1000 * 60 * 60 * 24);var milliSecond = $.toInt(totalMilliSecond) % 1000;var second = $.toInt(totalSecond) % 60;var minute = $.toInt(totalMinute) % 60;var hour = $.toInt(totalHour) % 24;var day = $.toInt(totalDay);return {TimeStamp: timestamp,Days: day,Hours: hour,Minutes: minute,Seconds: second,Milliseconds: milliSecond,TotalDays: totalDay,TotalHours: totalHour,TotalMinutes: totalMinute,TotalSeconds: totalSecond,TotalMilliseconds: totalMilliSecond,valueOf: function() { return this.TimeStamp; },toString: function() { return this.Days + "." + $.padLeft(this.Hours, 2, "0") + ":" + $.padLeft(this.Minutes, 2, "0") + ":" + $.padLeft(this.Seconds, 2, "0") + "." + $.padLeft(this.Milliseconds, 3, "0"); } };} 34 35 /*--时间相关函数 End----------------------------------------*/ 36 37 38 })(jQuery);
代码比较长，当时我写完之后，顺手就把 JS压缩了。
代码调用如下：
var begin = new Date(); //执行15W次 自动识别转换: //i3 CPU //Chrome: 5秒 平均: 30000次/s //IE 9 : 26秒 平均: 5770次/s //i5 CPU //Chrome: 14秒 20*100000次 平均: 107000次/s for (var i = 0; i < 10000; i++) { var result1 = $.toDateTime("2017-03-19 01:43:15 123453"); var result2 = $.toDateTime("2017-03-19T01:43:15 123453"); var result3 = $.toDateTime("2017-03-19"); var result4 = $.toDateTime("2017/03/19 01:43:15"); var result5 = $.toDateTime("03/19/2017 01:43:15"); var result6 = $.toDateTime("03/19/2017 01:43"); var result7 = $.toDateTime("01:43:15 123453"); var result8 = $.toDateTime("01:43:15.123453"); var result9 = $.toDateTime("01:43:15"); var result10 = $.toDateTime("01:43"); var result11 = $.toDateTime("2017/03/19"); var result12 = $.toDateTime("03/19/2017"); var result13 = $.toDateTime("Mon Mar 20 2017 02:46:06 GMT+0800 (中国标准时间)"); var result14 = $.toDateTime("Mon Mar 20 02:46:06 UTC+0800 2017"); var result15 = $.toDateTime("Mon Mar 20 2017 02:46:06"); var result16 = $.toDateTime("2017年3月19日 01时43分15秒"); var result17 = $.toDateTime("2017年03月19日01:43:15"); var result18 = $.toDateTime("2017年03月19日 01:43"); var result19 = $.toDateTime("2017年03月19日"); var result20 = $.toDateTime("1时43分15秒"); } var end = new Date(); document.writeln( "计算 " + (i) + "*20次, 耗时:" + "<br/>" + begin.format("yyyy-MM-dd HH:mm:ss fff") + "<br/>" + end.format("yyyy-MM-dd HH:mm:ss fff") + "<br/>" + "计算结果: " + "<br/> $.toDateTime(\"2017-03-19 01:43:15 123453\") >> " + result1.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017-03-19T01:43:15 123453\") >> " + result2.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017-03-19\") >> " + result3.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017/03/19 01:43:15\") >> " + result4.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"03/19/2017 01:43:15\") >> " + result5.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"03/19/2017 01:43\") >> " + result6.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"01:43:15 123453\") >> " + result7.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"01:43:15.123453\") >> " + result8.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"01:43:15\") >> " + result9.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"01:43\") >> " + result10.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017/03/19\") >> " + result11.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"03/19/2017\") >> " + result12.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"Mon Mar 20 2017 02:46:06 GMT+0800 (中国标准时间)\") >> " + result13.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"Mon Mar 20 02:46:06 UTC+0800 2017\") >> " + result14.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"Mon Mar 20 2017 02:46:06\") >> " + result15.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017年3月19日 01时43分15秒\") >> " + result16.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017年03月19日01:43:15\") >> " + result17.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017年03月19日 01:43\") >> " + result18.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"2017年03月19日\") >> " + result19.format("yyyy-MM-dd HH:mm:ss fff") + "<br/> $.toDateTime(\"1时43分15秒\") >> " + result20.format("yyyy-MM-dd HH:mm:ss fff") );
上面的代码中：
1 "Mon Mar 20 2017 02:46:06 GMT+0800 (中国标准时间)" 2 "Mon Mar 20 02:46:06 UTC+0800 2017" 3 "Mon Mar 20 2017 02:46:06" 4 5 这三种，分别是 Chrome FireFox IE 的 Date 对象 toString() 的结果。 6 万能函数 也已经进行了反向解析支持。
PS.
看客不禁哈哈大笑：“除非有BUG，否则这种 Date.toString() 的字符串 根本就不该出现在程序中。”
如果您觉得 这三种 字符串类型 不会出现。
—— 那我们看看 大名鼎鼎的 element-ui 库中，DatePicker 控件 是如何 闹心的：
http://element-cn.eleme.io/1.4/#/zh-CN/component/date-picker
http://element-cn.eleme.io/2.4/#/zh-CN/component/date-picker （新版已经修正了BUG）
我们再来看看 各位网友是如何踩坑的：
https://www.cnblogs.com/Mrrabbit/p/7716552.html
https://blog.csdn.net/fabulous1111/article/details/79566624
https://blog.csdn.net/lyz571029230/article/details/77987835
—— 无一例外：控件的值 不能直接获取，只能通过 change 事件取值。
如何获取时间差：
1 var timeSpan = $.getTimeSpan("2017-03-27 21:20:05 000", "2017-03-25 10:10:10 000"); 2 alert(timeSpan); //日期比较 是可以直接使用 > < 的 3 alert(timeSpan.TotalDays); //两个时间相差的天数（有小数，比如 1.5天） 4 alert(timeSpan.TotalHours); //两个时间相差的小时数（有小数） 5 alert(timeSpan.TotalMinutes); //两个时间相差的分钟数（有小数） 6 alert(timeSpan.TotalSeconds); //两个时间相差的秒数（有小数） 7 alert(timeSpan.TotalMilliseconds); //两个时间相差的毫秒数（有小数） 8 9 10 alert($.addYears("2017-03-27 21:20:05 123456", 5)); //在指定时间基础上，增加 5 年 11 alert($.addMonths("2017-03-27 21:20:05 123456", 48)); //在指定时间基础上，增加 48 月 12 alert($.addDays("2017-03-27 21:20:05 123456", 365)); //在指定时间基础上，增加 365 天 13 alert($.addHours("2017-03-27 21:20:05 123456", 48)); //在指定时间基础上，增加 48 消失 14 alert($.addMinutes("2017-03-27 21:20:05 123456", 120)); //在指定时间基础上，增加 120分钟 15 alert($.addSeconds("2017-03-27 21:20:05 123456", 480)); //在指定时间基础上，增加 480秒 16 alert($.addMilliseconds("2017-03-27 21:20:05 123456", 10300)); //在指定时间基础上，增加 10300毫秒
是的， JS 的 Date 对象， 好多你需要但是 底层不提供的 函数 —— 本文 都已经提供。
本文源码，完全开源，才用 MIT 开源协议 —— 源码可以用于 个人、商业，可以修改、添加、删除，仅仅需要保留 作者的著作声明。
源码早在2017年完成，这次项目需要用到 TypeScript —— 于是，就将 之前的部分 底层Js代码，进行了移植。
今天顺带踩了一下 element-ui 的坑，发文纪念一下 ~
InkFx
2018-08-16
