easydate使用

墨蓝 2021-06-24 15:59 348阅读 0赞

easydate.js 是一款简易实用的JavaScript日期时间处理工具！在原生Date对象的基础上，提供了日期输出的格式化，以及日期时间的加减计算、时差计算、条件判断、链式操作等功能，方便项目中日期时间的处理！

1、使用easydate  
1）Node.js：

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

2）amd：

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

3）script：

2、关于easydate：

1）使用easydate函数创建实例：

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

2）判断：

// (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');

3）获取日期、时间部分：

// (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();

4）格式化；

yyyy - 四位数字的年份
    yy - 两位数字的年份
    MM - 两位数字的月份
    M - 月份
    dd - 两位数字的天数
    d - 天数
    HH - 两位数字的24小时制时钟
    H - 24小时制时钟
    hh- 两位数字的12小时制时钟
    h- 12小时制时钟
    mm - 两位数字的分钟
    m - 分钟
    ss - 两位数字的秒钟
    s - 秒钟
    tt - 上午/下午
    S - 毫秒

// 格式化输出 '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()；

5）日期计算：

// 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();

6）设置日期时间的指定部分  
操作结果返回 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);

7）计算时间差  
对于日期比较类方法的参数类型，可以是日期字符串、时间戳、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天)

链式操作：

easydate('2018/03/17 16:08:32').toDatePart().calc('day', 6).calc('hour', 12).format();

静态方法：

// 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秒钟）

官网：

https://github.com/springlong/easydate.js