之前发布过一个PHP类库：lv、现在发布一个js的类库：lv-js。类库中第一个类为时间操作类：DateQuery；之前有写过很多时间操作的方法（篇尾提供），经过加工、修改提供。类库的风格和php类库一样，从简、方便使用。

类库git仓库

https://coding.net/u/levi/p/levi-js/git

最近更新日期：2014.11.08，最新稳定版为：0.1.3，点击查看更新说明 >

在说这个类库前，大家先自己想想这么几个问题：

1. 如何获取当前时间、指定时间
2. 如何添加时间
3. 如何计算时间间隔
4. 如何获取指定时间格式：时间戳、UTC、GMT、年月日

我先提供一个简单的倒计时，如果用原生的JS计算倒计时是一件很复杂的事情，而使用这个类库，那么你可以将其简化如下：

setInterval(function() {
    lv.date().set('2015-11-12 11:00:20', true).get('g', true);
}, 100);

当然，这只是举例，如果需要输出到Dom中，实际还需要添加一些其他方法，下面是一个简单的演示

设置时间

lv.date();

返回值：lv.date对象

参数：可以包含以下类型参数

为空或null

lv.date();

如果不设置参数，则获取当前时间。注意哦，如果你设置的时间不正确，也默认为当前时间，例如：

lv.date('我就是来捣乱的');    // 返回当前时间的DateQuery对象

UNIX时间戳（number类型）

lv.date(1414725480348);            // 直接设置时间戳
lv.date(new Date().valueOf());    // 通过Date设置时间戳

日期格式的字符串（string类型）

// 设置日期格式
lv.date('1986-11-5');
lv.date('11/5/1986');

// 设置时间点，精确到毫秒
lv.date('1986-11-5 3:59:00.032');

// 设置GMT时间
lv.date('Wed, 09 Aug 1995 00:00:00 GMT');

如果传入的是字符型，那么可以接受Date.parse所有支持的参数种类，如：

• 1986-11-5
• 1986-11-5 3:59:00
• 1986/11/5
• 11/5/1986
• Aug 9, 1995
• Wed, 09 Aug 1995 00:00:00 GMT

更多参数见官方文档：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date/parse

为了兼容IE6等低版本浏览器，以及从语义通俗易懂的角度来看，建议尽量使用：2012-11-10 11:00:02这样的字符（见：日期规范 >）。

在0.1.3之后支持一些特殊格式日期，如：

• 空格间隔日期：2012 12 14

数组（2014.11.7 新增）

lv.date([2014, 11, 12, 11, 02, 34]);

数组值从前到后，分别为：年、月、日、小时、分、秒；不支持：毫秒、周这类时间，也可以单独设置一段时间，例如：

// 输出：Tue Dec 31 2013 00:00:00 GMT+0800 (CST)
lv.date([2014]);

// 输出：Fri Oct 31 2014 00:00:00 GMT+0800 (CST)
lv.date([2014, 11]);

// Thu Nov 13 2014 00:00:00 GMT+0800 (CST)
lv.date([2014, 11, 13]);

注意哦，请不要将时间、日期单独作为参数请求，如：

// 输出：Thu Jan 01 1970 08:00:02 GMT+0800 (CST)
lv.date(2014);

// 实际相当于
new Date(2014);

Date 对象（2014.11.7 新增）

0.1.3之前并不支持Date对象，这点也是后来才发现很奇怪的地方。0.1.3后新增，如下：

lv.date(new Date());                // 设置当前时间
lv.date(new Date('2014/11/16'));    // 设置指定时间

Object/JSON对象

lv.date({FullYear: 1986, Month: 10});

对象属性名请参照Date对象的set方法，例如：

• setFullYear：FullYear
• setMonth：Month

所有的属性名均和方法名一致，不包含方法名字前三个字符“set”，属性名必须按照大小写来

注意哦，通过这样的方式设置月份需要-1；例如11月，实际上设置的值为10

DateQuery对象

lv.date(lv.date('2012-11-2'));

// 这种方法经常用于设置间隔时间
var date = lv.date('2017-11-6');
lv.date().set(date, true);

更新设置时间

lv.date().set('2014-11-12 11:12:30.001');

返回值：lv.date对象

参数：参考初始化时的参数设置

若需要更新为当前时间，可以使用下面的方法

lv.date('1986-11-05').set();

设置间隔截止时间

lv.date().set('2017-11-12 11:12:30.001', true);

可以通过给set方法的第二个参数传入true，来设置两个时间点，这样可以比较获取两个时间点的差值等其他用途

获取时间

获取时间也是这个对象的特点之一，参考了PHP的Date函数，支持的参数也和Date函数一样，略有差异；相信情况见篇尾附录表格，这里我只列举几个简单的列子：

lv.date().get();                   // 输出格式：Wed Nov 01 2000 00:00:00 GMT+0800
lv.date().get('Y-m-d H:i:s');      // 输出格式：2000-11-01 17:23:03
lv.date().get('Y年m月j日 星期w');    // 输出格式：2000年11月1日 星期5
lv.date().get('U');                // 输出格式：当前UNIX时间戳 - 973008000000

获取时间接受注释符号“/”，例如：

// 输出格式：2014-10-31，在Y镇有一个叫j的姑娘...
lv.date().get('Y-m-d，在/Y镇有一个叫/j的姑娘...');

注意哦，是“/”，不是“”，因为在字符中要获取“”，需要设置为“”；避免麻烦，我用了“/”

lv.date().set('2015-11-2', true).get('', true);

lv.date().set('2015-11-2', true).get('', true);     // 以毫秒为单位获取差额时间
lv.date().set('2015-11-2', true).get('h', true);    // 以天为单位获取差额时间

var date = lv.date('2014-11-27').set('2014-12-4', true).get('d', true);
Math.floor(date/30);

lv.date().set('2015-11-12 11:00:20', true).get('g', true);

[1, 736, 23, 11, 22, 16, 12, 1]

lv.date().set('2015-11-12 11:00:20', true).get(['s', 'i', 'h', 'd', 'w'], true);

比较时间

2014.11.5增加，之前的方法中只提供了时间差额获取方法：getBetween；上面有提到，这个方法返回的永远是时间差额，且是正数；那么就无法满足下面两个需求：

• 如果在获取“单项数据”（秒或分或年或月）时，就无法得知是否超出了初始时间
• 我只希望临时比较一个时间，而不是非要修改最终间隔时间，比较的这个时间只在当前方法中使用

对于第一个需求只要设置第一个参数（当然也可以默认不传任何参数，默认）；第一个参数为获取日期的单位，参数的形式请参照方法：get中的第一个参数：

// 获取两天的间隔时间，单位：毫秒，输出：86400000
lv.date('2012-11-12').set(2012-11-13).diff();

// 获取两天的间隔时间，单位：毫秒，输出：-86400000
lv.date('2012-11-14').set(2012-11-13).diff();

对于第二个需求，可以给第二个参数传入一个时间作为临时比较的时间：

var date = lv.date('2012-11-2').set('2012-11-3');

// 查看时间间隔，输出：86400000
data.get('', true);

// 两个时间相比较，输出：86400000
data.diff();

// 给起始时间增加2天再比较，输出：-86400000
data.add(2, 'd').diff();

// 比较一个临时的时间，它不会被记录，输出：86400000
data.add(2, 'd').diff('', '2015-11-5');

// 再回头看看起止两个时间相比较（别忘了，之前咱给起始时间加过两天咯），输出：-86400000
data.diff();

注意哦：

• lv.date所有时间设置的格式，均参照方法：set，无论是：初始时间、更新时间、截止时间、临时比较时间
• diff方法中没有传入第二个参数，均以“截止时间”为“临时比较时间”

增加或删除时间

lv.date().add(1000000);     // 增加1000000毫秒
lv.date().add(-1000000);    // 减少1000000毫秒
lv.date().add(1, 'h');      // 增加1小时
lv.date().add(1, 'd');      // 增加1天
lv.date().add(1, 'y');      // 增加1年

参数：

• num：时间，正数为增加，负数为减少
• type：单位，默认是毫秒，其他几个单位包含有
  ms – 毫秒、s – 秒、i – 分、h – 小时、d – 天、w – 周、m – 月、y – 年

时间单位不区分大小写

• between：布尔值，true设置间隔时间，false设置当前时间，默认是false

遍历时间

2014.11.5新增，之前和朋友沟通的时候有提到希望用这个时间类做一个日历插件。我大致思考了下，如果在不更新时间遍历的方法来看，也能实现，无非自己写个循环，但是我觉得我可以帮你做的更简单点，就像这样：

lv.date().walk('m', 'd', function() {
    console.log(this.get('Y-m-d 星期：') + ['日', '一', '二', '三', '四', '五', '六'][this.get('w')]);
});

通过上面的方法，会将当前月份，以天为间隔单位，通过闭包的方式循环输出lv.date对象（剩下的，只需在闭包中通过get方法，输出指定时间格式）。这篇文章通过walk方法，制作了一个简单的日历演示，你可以点击连接查看：

http://levi.yii.so/archives/3728

返回值：lv.date对象，不受walk传参影响，记录的时间为最近set的时间

参数：

// 从2012-11-2到2012-11-30，按照天为单位，循环输出DateQuery对象
lv.date('2012-11-2').walk('2012-11-30', 'd', function() {});

// 以2012年11月为例，将从自然月1号到30号，按照天为单位，循环输出DateQuery对象
lv.date().walk('m', 'd', function() {});

// 从2012-11-1到2012-12-31，按照天为单位，循环输出DateQuery对象
lv.date().walk({
    stat: '2012-11-1',
    end: '2012-12-31'
}, 'd', function() {});

// 从2012-11-1到2012-12-31，按照天为单位，循环输出DateQuery对象
lv.date('2012-11-1').set('2012-12-31').walk('', 'd', function() {});

// 一天中以小时为单位，循环输出DateQuery对象
lv.date().walk('d', 'h', function() {});

// 指定时间，以小时为单位，循环输出DateQuery对象
lv.date('2012-11-1 22:00:00').walk('2012-11-1 23:59:00', 'h', function() {});

// 按照年为单位，下面结果只能返回一次回调
lv.date('2012-11-1 22:00:00').walk('2012-11-1 23:59:00', 'y', function() {});

// 每10分钟响应一次回调
lv.date('2012-11-1 22:00:00').walk('2012-11-1 23:59:00', 60000, function() {});

// 将12月的日期按照日历的方式全部输出
lv.date('2012-12-1').walk('m', 'd', function() {
    console.log(this.get('Y-m-d 星期：') + ['日', '一', '二', '三', '四', '五', '六'][this.get('w')]);
});

// 指定日期
var date = lv.date('2012-11-1').walk();

// 也可以计算设置日期
date.add(1, 'm').walk()

lv.date('2012-11-1 22:00:00').walk('2012-11-1 23:59:00', null, function() {});

lv.date().walk('m', 'd', function(num, limit) {
    console.log(num);      // 打印当前回调的顺序
    console.log(limit);    // 打印间隔时间
});

还是会到最开始“日历”这个需求，现在要获取当前月份、上个月、下个月的日期相当容易，还可以指定输出2个月或3个月，也可以输出1周的日期；你也可以将输出的日期按照自己要求获取展示格式，至于如何更新时间：点击、悬停、滑动，这个就看你个人意愿了，lv.date都挺方便哒~

临时处理时间方法

2014.11.5新增，考虑这么一个过程，如果我需要暂时对时间进行不同的处理，并在处理完成后再设置回来，需要几个步骤？具体步骤我就不再说明了，不过通过temp这个方法可以大大简化这个过程，代码如下：

// 即便在闭包中给this增加了时间，但是最终记录的时间依然不变
lv.date().temp(function() {
    // 临时增加1天作为比较
    this.add(1, 'd').diff();
}).get();

返回值：当前lv.date对象

这个方法挺实际的，有兴趣可以好好研究研究，这里就列这么多，在类中用了不少temp方法，可以看看

将时间按照对象输出

lv.date().toData();
lv.date().toData(null, true);

返回值如下：

["2014", "10", "31", "12", "58", "50"]
{y: "2014", m: "10", d: "31", h: "12", i: "58", s: "50"}

参数：

• data，获取时间格式，数组形式，请参照附录中的时间格式表
• met，true为对象格式，false为数组格式

若没有提供参数，默认为：[‘Y’, ‘m’, ‘d’, ‘H’, ‘i’, ‘s’]

获取一段时间起止点

在传统的new Date对象中可以获取当前对象为第几天、星期几，也可以通过lv.date包装获取当月最大天数，但是还是少了点什么，比如说：以当前设置时间为基准，获取当月第一天、最后一天；当年第一天、最后一天、当月第一天最后一天；等等，诸如此类。

2014.11.5新增方法：getPot，根据设定时间得到指定起止点：

lv.date().getPot('m');          // 获取本月开始时间
lv.date().getPot('m', true);    // 获取本月结束时间
lv.date().getPot('q');          // 获取本季度开始时间
lv.date().getPot('q', true);    // 获取本季度结束时间
lv.date().getPot('d');          // 获取本天开始时间
lv.date().getPot('d', true);    // 获取本天结束时间

返回值：new Date对象，注意不是lv.date对象哦；同样，getPot获取的值也不会作为时间记录在lv.date对象中。如果你需要将返回的对象变为时间戳、或是再利用，可以这样：

// 将返回的对象转化为时间戳
+lv.date().getPot('m');

// 将返回的对象再次利用
lv.date(+lv.date().getPot('m'));

参数：

• name：单位名称，分别为
  y-年、q-季度、m-月、d-天、h-小时、i-分、s-秒

注意哦：没有毫秒，因为使用过程中基本用不上

• end：若设置为true将获取指定单位的截止时间，默认是undefined

静态方法

字符串转换为时间对象

lv.date.strTotime('2012-11-12');

参数见DateQuery对象中的set方法

判断是否为正确的时间格式

lv.date.isDate('2012-11-12');

获取当前类库版本号

lv.date.version

更新记录

为了方便查看，以后DateQuery的更新日志，只在这篇文档中更新。如果你你需要获取更新提醒，可以关注我的git：https://coding.net/u/levi/p/levi-js/git

附录：时间格式表

在获取特定时间时，传入特定格式作为get参数使用；DateQuery的时间格式是以PHP的Date函数为原型作为参考，有细微差别，大致情况如下：

注解说明：

1. 参数l、F：在PHP中是获取完整的星期、月份的英文名称，而JS中并未有完整的名称，所以目前着两个参数只能返回名称简称
2. ISO-8601：在PHP中获取 ISO-8601，是以当前的时区时间；JS中获取ISO-8601的是UTC时间，可能会造成时间误差；例如：咱们是+08:00，将会有8个小时的误差
3. 参数N：chrome等现代浏览器中是以GMT（根据本地情况）来计算时间，而IE6等早前浏览器，则是根据UTC来计算时间，所以IE6获取的时间差1天
4. 参数W：PHP中是根据 ISO-8601来获取当前的时间，由于PHP和JS的差异，参见：注解2；所以在Date类中避免时间误差，采用的是当前的时间，而非 ISO-8601
5. 参数o：PHP中会根据当前星期数来决定当前时间，所以会出现：2012-12-31属于2013年，而JS中则是根据自然日为准，2012-12-31属于2012年
6. 参数u：PHP毫秒计算到6位，而JS则是计算到3位
7. 参数e、T：在IE6等早前的浏览器中，并没有时区名称，所以在这里返回当前时区的数值，例如：8；而在chrome中则是返回cst这样的时区名称
8. 参数U：在PHP中时间戳是按照秒计算，而当前类中采用了JS的统计方式，按照毫秒来计算

后记：附录

lv.date('2014/0/0');

参考资料：

您可能也喜欢：
Mac下配置Redis服务器（自启动、后台运行）	通过 Google Docs 加密你的 Gmail 邮件	linux使用crontab实现PHP执行定时任务	初识 jQuery Deferred	一句话删除目录下所有文件
无觅