exdate

the best date tool for javascript/node

#便捷的javascript date 处理工具

##目的 javascript 日期对象格式化,字符串转日期对象,日期格式检查,日期比较以及日期间隔的工具

##安装

  1. 安装node,参见:https://github.com/joyent/node

  2. 安装npm,参见:https://github.com/isaacs/npm

  3. 安装xdate

    $ npm install xdate

##日期格式说明

FieldFull FormShort Form
Yearyyyy (4 digits)yy (2 digits), y (2 or 4 digits)
MonthMMM (name or abbr.)MM (2 digits), M (1 or 2 digits)
Day of Monthdd (2 digits)d (1 or 2 digits)
Day of WeekEE (name)E (abbr)
Hour (1-12)hh (2 digits)h (1 or 2 digits)
Hour (0-23)HH (2 digits)H (1 or 2 digits)
Hour (0-11)KK (2 digits)K (1 or 2 digits)
Hour (1-24)kk (2 digits)k (1 or 2 digits)
Minutemm (2 digits)m (1 or 2 digits)
Secondss (2 digits)s (1 or 2 digits)
AM/PMa

##API

* @param {Integer} year
* @return {Boolean} true 是闰年 false 不是闰年
* @param {String} val 日期字符串
* @param {String} pattern 日期格式, 可省略, 默认值 yyyy-MM-dd
* @return {Boolean} true 是符合格式的日期字符串 false 不是
* @param {Date} date1 起始日期
* @param {Date} date2 结束日期
* @return {Integer} -1 起始日期 > 结束日期; 0 起始日期 = 结束日期; 1 起始日期 < 结束日期
* @param {String} string1 起始日期字符串
* @param {String} pattern1 起始日期格式
* @param {String} string2 结束日期字符串
* @param {String} pattern2 结束日期格式
* @return {Integer} -1 起始日期 > 结束日期; 0 起始日期 = 结束日期; 1 起始日期 < 结束日期
* @param {String} val 日期字符串
* @param {String} pattern 对应的日期格式, 可省略, 默认值 yyyy-MM-dd
* @return {Date} 日期对象,如果不能正确解析该字符串,返回0
* @param {Date} date 需要格式化输出的日期对象
* @param {String} pattern 格式化字符串, 可省略, 默认值 yyyy-MM-dd
* @return {String} 格式化后的字符串
* @param {Date} date 基准日期
* @param {Integer} n n个时间
* @param {String} unit 时间单位,默认天,具体单位分别是:y年,q季度,M月,h时,m分,s秒,w周,其他都是天
* @return {Date} 日期对象

详细的使用参看sample中的例子