一个超轻量级的时间处理工具库 - dateformat.js

阅读 3690
收藏 164
2017-04-19
原文链接:github.com

dateformat.js 是一个非常简洁、轻量级、不到 5kb 的很简洁的 Javascript 库, 它是一个时间的处理工具类。

  • 支持常用的时间格式化
  • 得到当前星期,时间对比大小,是否为闰年
  • 增加日期,增加月份,增加年份等等
  • 支持自动实时更新;
  • 支持浏览器script方式;
  • 测试用例完善,执行良好;

使用方法

1. 引入 timeago.js

通过 script 标签引入到html文件中,会生成一个全局变量 DateFormat.

<script src="dist/timeago.min.js"></script>

当然你还可以在通过 import 引入

import dateformat form '...自己的路径';

最后该项目也上传到npm上,你可以通过

//安装
npm install dateformat-util  
//使用
var dateformat = require('dateformat');
var df = new dateformat();
df.format(new Date());

3. 使用 dateformat

直接调用方法即可

DateFormat.format(new Date(), 'yyyy-MM-dd hh:mm:ss');

具体方法

1. format(date, fmt)

format 是将 Date类型的时间进行格式化的工具方法:

DateFormat.format(new Date()) //不传 fmt,则默认为 yyyy-MM-dd hh:mm:ss ;
DateFormat.format(new Date(), 'yyyy-MM-dd hh:mm:ss');
DateFormat.format(new Date(), 'yyyy/MM/dd hh:mm:ss');
DateFormat.format(new Date(), 'yyyy/MM/dd');
...

2. formatToDate(dateStr)

formatToDate 是将 字符串类型的时间 转化成 Date 类型的工具方法:

DateFormat.formatToDate('2017-04-18 12:12:12');
DateFormat.formatToDate('2017/04/18 12:12:12');
...

3. getDateStart(date)

getDateStart 是得到一天的开始,工作中会碰到这种需要得到某一天的开始或结束的时间点。

DateFormat.getDateStart(new Date());  //今天是4.18, 那返回的是今天 00:00:00的Date类型

如果想返回字符串类型,可以使用 getDateStartStr(date, fmt) 方法,fmt非必传

DateFormat.getDateStartStr(new Date(), 'yyyy-MM-dd hh:mm:ss'); //返回 2017-04-18 00:00:00

4. getDateEnd(date)

getDateEnd 是得到一天的结束

DateFormat.getDateEnd(new Date());  //今天是4.18, 那返回的是今天 23:59:59的Date类型

如果想返回字符串类型,可以使用 getDateEndStr(date, fmt) 方法,fmt非必传

DateFormat.getDateEndStr(new Date(), 'yyyy-MM-dd hh:mm:ss'); //返回 2017-04-18 23:59:59

5. compareDate(d1, d2)

compareDate 比较两个日期的大小 返回 1 , 则 d1 > d2 返回 0 , 则 d1 == d2 返回 -1, 则 d1 < d2

DateFormat.compareDate(new Date(), new Date()); 

6. getWeek(date, type)

getWeek 得到一个日期是星期几

DateFormat.getWeek(new Date());  //type非必传,默认返回 '星期 X'的格式
DateFormat.getWeek(new Date(), DateFormat.WEEKTYPE.US_DAYNAME); // Monday


/*
type 枚举如下:

DateFormat.WEEKTYPE.ZH_DAYNAME :      星期一
DateFormat.WEEKTYPE.ZH_SHORTDAYNAME:  周一
DateFormat.WEEKTYPE.US_DAYNAME:      Monday
DateFormat.WEEKTYPE.US_SDAYNAME:     Mon
*/

7. addDay(date, num)

增加系列:

addDay(date, num) 
addDayStr(dateStr, num) 
addMonth(date, num)
addMonthStr(dateStr, num)
addYear(date, num)
addYearStr(dateStr, num)

使用起来很简单,今天是 2017.04.18

DateFormat.addDay(new Date(), 3);   //返回是三天后的  Date类型
DateFormat.addDayStr('2017-04-18 12:12:12', 3) // 返回 Fri Apr 21 2017 12:12:12 GMT+0800 (中国标准时间)

// 其他 month year的方式同上

本文对你有帮助?欢迎扫码加入前端学习小组微信群:

评论