一款简易实用的JavaScript日期时间处理工具！

一款简易实用的JavaScript日期时间处理工具！

在原生Date对象的基础上，提供了日期输出的格式化，以及日期时间的加减计算、时差计算、条件判断、链式操作等功能，方便项目中日期时间的处理！

Node.js：

npm install easydate.js

const easydate = require('easydate.js');

amd：

define(['easydate.js'], function(easydate){ });

script tag：

<script src="easydate.js"></script> 关于easydate 使用easydate函数创建实例

// 给定日期字符串 const edate = easydate('2018/03/17 16:08:32'); // 给定时间戳 const edate2 = easydate(1521274112000); // 给定已有日期对象 const edate3 = easydate(new Date()); // 默认当前系统时间 const edate4 = easydate(); 条件判断

对于日期比较类方法的参数类型，可以是日期字符串、时间戳、Date对象实例、easydate对象实例。

// (boolean) 判断日期时间的有效性 edate.isValid(); // (boolean) 判断是否是闰年 edate.isLeapYear(); //(boolean) 判断当前日期是否在目标日期之前 edate.isBefore('2018/03/18'); // (boolean) 判断当前日期是否在目标日期之后 edate.isAfter('2018/03/16'); // (boolean) 判断当前日期是否和目标日期一致 edate.isSame('2018/03/17 16:08:32'); // (boolean) 判断当前日期是否介于两个日期之间 edate.isBetween('2018/03/18', '2018/03/16'); 获取日期时间的信息部分

// (Date) 日期对象 edate.date; // (number) 返回毫秒级快照 edate.valueOf(); // (number) 返回年份 edate.getFullYear(); // (number) 返回月份，月份值从1~12 edate.getMonth(); // (number) 返回当月的第几天 edate.getDate(); // (number) 返回当周的第几天，值从0~6表示周日~周六 edate.getDay(); // (number) 返回时钟 edate.getHours(); // (number) 返回分钟 edate.getMinutes(); // (number) 返回秒钟 edate.getSeconds(); // (number) 返回毫秒数 edate.getMilliseconds(); // (number) 返回当前日期时间属于一年中的第几周 edate.getWeekth(); // (number) 返回当前日期时间所处的当月有多少天 edate.getMonthDays(); 日期时间的格式化输出

格式化字符码：

// 格式化输出 '2018/03/17 16:08:32' // 等同于.format('yyyy-MM-dd HH:mm:ss') edate.format(); // 格式化输出 '18/3/17 16:8:32' edate.format('yy-M-d H:m:s'); // 格式化输出 '2018/03/17 16:08:32' edate.format('yyyy-MM-dd HH:mm:ss'); // 格式化输出 '2018年03月17日 下午 04:08:32' edate.format('yyyy年MM月dd日 tt hh:mm:ss'); // 返回日期时间的字符串表示 'Sat Mar 17 2018 16:08:32 GMT+0800 (中国标准时间)' edate.toString(); // 返回本地格式的日期时间字符串 '2018/3/17 下午4:08:32' edate.toLocaleString(); // 返回本地格式的日期字符串 '2018/3/17' edate.toLocaleDateString(); // 返回本地格式的时间字符串 '下午4:08:32' edate.toLocaleTimeString(); // 根据世界时返回日期时间字符串 'Sat, 17 Mar 2018 08:08:32 GMT' // 请使用toUTCString()代替 edate.toGMTString()； // 根据世界时返回日期时间字符串 'Sat, 17 Mar 2018 08:08:32 GMT' edate.toUTCString()； 日期时间的计算

操作结果返回 easydate 实例本身，因此可以进行链式操作。

支持正负数，正数表示加上指定时间，负数表示减去指定时间。

// edate的参照值： // 2018/03/17 16:08:32 // 秒钟+1 // 2018/03/17 16:08:33 edate.calc('second', 1); // 分钟+1 // 2018/03/17 16:09:33 edate.calc('minute', 1); // 时钟+1 // 2018/03/17 17:09:33 edate.calc('hour', 1); // 天数+1 // 2018/03/18 17:09:33 edate.calc('day', 1); // 月份+1 // 2018/04/18 17:09:33 edate.calc('month', 1); // 年份+1 // 2019/04/18 17:09:33 edate.calc('year', 1); // 截取日期部分 // 2018/04/18 00:00:00 edate.toDatePart(); // 克隆一份副本 // 2018/04/18 00:00:00 edate.clone(); 设置日期时间的指定部分

操作结果返回 easydate 实例本身，setMonth()中月份的值从 1 ~ 12 。

// edate的参照值： // 2018/04/18 00:00:00 // 设置年份 2018/04/18 00:00:00 edate.setFullYear(2019); // 设置月份 2018/06/18 00:00:00 edate.setMonth(6); // 设置当月的第几天 2018/06/25 00:00:00 edate.setDate(25); // 设置时钟 2018/06/25 10:00:00 edate.setHours(10); // 设置分钟 2018/06/25 10:32:00 edate.setMinutes(32); // 设置秒钟 2018/06/25 10:32:58 edate.setSeconds(58); // 设置毫秒 2018/06/25 10:32:58 100 edate.setMilliseconds(100); 计算时间差

对于日期比较类方法的参数类型，可以是日期字符串、时间戳、Date对象实例、easydate对象实例。

// edate的参照值： // 2018-03-23 12:00:00 edate.diff('2018-03-24 16:30:55', 'json'); // {year: 0, month: 0, day: 1, hour: 4, minite: 30, second: 55} edate.diff('2018-03-24 16:30:55', 'year'); // 0 (相差不足1年) edate.diff('2018-03-24 16:30:55', 'month'); // 0 (相差不足1个月) edate.diff('2018-03-24 16:30:55', 'day'); // 1 (相差1天) edate.diff('2018-03-24 16:30:55', 'hour'); // 28 (相差28个小时) edate.diff('2018-03-24 16:30:55', 'minute'); // 1710 (相差1710分钟) edate.diff('2018-03-24 16:30:55', 'second'); // 102655 (相差102655秒) edate.diff('2018-03-24 16:30:55'); // 1 (相差1天) 链式操作

// output: 2018/03/23 12:00:00 easydate('2018/03/17 16:08:32').toDatePart().calc('day', 6).calc('hour', 12).format(); 静态方法

对于日期比较类方法的 dateStr 参数的类型，可以是日期字符串、时间戳、Date对象实例、easydate对象实例。

// easydate.isValid(dateStr) // 判断日期时间的有效性 // 返回值类型: boolean easydate.isValid(); // false easydate.isValid('2018-03-28 xx:33:25'); // false easydate.isValid('2018-03-28 18:33:25'); // true // easydate.isLeapYear(year) // 判断是否为闰年 // 返回值类型: boolean easydate.isLeapYear(); // false easydate.isLeapYear(2018); // false easydate.isLeapYear(2020); // true // easydate.getWeekth(dateStr) // 返回一个日期时间处于一年中的第几周 // 返回值类型：number // 如果是无效日期则返回NaN easydate.getWeekth('2018-01-01'); // 1 easydate.getWeekth('2018-12-29'); // 52 easydate.getWeekth('2018-12-31'); // 53 // easydate.getMonthDays(dateStr) // 返回一个日期时间所处的当月有多少天 // 返回值类型：number // 如果是无效日期则返回NaN easydate.getMonthDays('2018-01-01'); // 31 easydate.getMonthDays('2018-02-01'); // 28 easydate.getMonthDays('2018-03-01'); // 31 easydate.getMonthDays('2018-04-01'); // 30 // easydate.diff (startDate, endDate, unit) // 计算两个日期之间的时间差，单位默认以“天”表示 easydate.diff('2018-01-01', false); // NaN easydate.diff('2018-01-01', '2018-01-01'); // 0（相差0天） easydate.diff('2018-03-14', '2018-03-30'); // 16 （相差16天） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'json'); // {year: 0, month: 0, day: 25, hour: 2, minite: 20, second: 1, maxUnit: 'day'} easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'json'); // {year: 1, month: 0, day: 3, hour: 2, minite: 20, second: 1, maxUnit: 'year'} easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'year'); // 1 （相差1年） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'month'); // 12 （相差12个月） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'day'); // 368 （相差368天） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'hour'); // 8834 （相差8834小时） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'minute'); // 530060 （相差530060分钟） easydate.diff('2018-01-31 10:30:55', '2019-02-03 12:50:56', 'second'); // 31803601 （相差31803601秒钟）