什么是 handy-ms
handy-ms 是一个 npm 包,用于在前端代码中轻松处理时间和日期。它提供了众多便利的方法和常用时间格式的处理,让时间处理变得十分简单和高效。
安装和使用
可以通过 npm 进行全局安装
npm install handy-ms -g
在代码中引用
const hm = require('handy-ms');
常用 API
hm.now()
获取当前时间戳
const now = hm.now(); console.log(now); // 1614885471828
hm.format(date, format)
将时间戳格式化为所需的时间格式,第一个参数为时间戳,第二个参数为指定的格式字符串。
const date = 1614885471828; const formatStr = 'YYYY-MM-DD HH:mm:ss'; const formattedDate = hm.format(date, formatStr); console.log(formattedDate); // 2021-03-04 23:17:51
hm.add(date, amount, unit)
将指定的时间加上时间量,第一个参数为时间戳,第二个参数为需要增加的时间量,第三个参数为对应的时间单位。
const date = 1614885471828; const amount = 10; const unit = 'days'; const newDate = hm.add(date, amount, unit); console.log(newDate); // 1615685471828
hm.difference(date1, date2)
计算两个时间之间的时间间隔,单位为毫秒
const date1 = 1614885471828; const date2 = 1614885472830; const diff = hm.difference(date1, date2); console.log(diff); // 1002
时间格式字符串
hm.format 可以接受一些列的时间格式字符串,下面列举了一些常用的格式。
格式 | 描述 |
---|---|
YYYY | 完整的年份,例如 2021 |
YYYYMM | 完整的年份和月份,例如 202103 |
YYYYMMDD | 完整的日期,例如 20210304 |
HH | 小时,例如 23 |
mm | 分钟,例如 58 |
ss | 秒钟,例如 51 |
SSS | 毫秒,例如 828 |
A | 上午/下午 |
D | 星期几 |
总结
handy-ms 可以帮助我们在前端代码中轻松处理时间和日期,提高开发效率。文章中给出了手把手的教程和常用 API 的介绍,希望对读者有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600554fd81e8991b448d2350