前言
在 Web 开发中，操作日期时间是非常常见的操作之一。JavaScript 自带的 Date 对象可以处理时间戳，但如果想要更加便捷地操作日期时间，我们可以使用第三方库 date-utils。本文将详细介绍 date-utils 的使用方法，旨在让前端工程师快速上手。
安装
通过 npm 安装 date-utils：
npm install date-utils --save
使用方法
安装完成后，在代码中引入：
const date = require('date-utils');获取当前时间
获取当前时间，使用 Date 实例的 toDate 方法：
const now = new Date().toDate(); console.log(now);
输出：
Thu Sep 09 2021 21:45:20 GMT+0800 (China Standard Time)
格式化时间
使用 format 方法格式化时间：
const now = new Date();
const formatted = now.toFormat('YYYY-MM-DD HH24:MI:SS');
console.log(formatted);输出：
2021-09-09 21:46:38
format 方法支持的格式化符号：
| 符号 | 说明 |
|---|---|
| YY | 年份的后两位数 |
| YYYY | 完整的年数 |
| MM | 月（01~12） |
| MON | 英文月份缩写（Jan~Dec） |
| MONTH | 英文月份全称（January~December） |
| W | 一年中的第几周（00~53） |
| D | 一年中的第几天（001~365或366，根据年份不同） |
| DD | 一年中的第几天，两位数字（01~365或366，根据年份不同） |
| DDD | 月份中的第几天（1~31） |
| HH24 | 时，24 小时制（00~23） |
| HH | 时，12 小时制（01~12） |
| MI | 分钟（00~59） |
| SS | 秒（00~59） |
| SSS | 毫秒（000~999） |
| DAY | 该日期所属的星期的第几天，英文缩写（Sun~Sat） |
| DAYW | 该日期所属的星期的第几天，英文全称（Sunday~Saturday） |
| TZD | 时区的缩写（GMT、EST） |
| TZH | 时区的小时数（+02 表示 UTC+2，-05 表示 UTC-5） |
| TZH24 | 时区的小时数，24 小时制（+02 表示 UTC+2，-05 表示 UTC-5） |
| TZZ | 时区的时差，冒号分隔格式（+08:00 表示 UTC+8，-05:00 表示 UTC-5） |
| T | 以指定的格式显示该时间的 ISO 8601 值 |
解析时间
使用 fromFormat 方法解析时间：
const str = '2021-09-09 21:46:38'; const date = new Date().fromFormat(str, 'YYYY-MM-DD HH24:MI:SS'); console.log(date);
输出：
Thu Sep 09 2021 21:46:38 GMT+0800 (China Standard Time)
时间操作
date-utils 还提供了一些便捷的时间操作方法，例如：
- addDays / addHours / addMinutes / addSeconds / addMilliseconds：增加天 / 小时 / 分钟 / 秒 / 毫秒；
- isBefore / isAfter：比较时间的前后；
- equals：判断两个时间是否相等；
- ...
参考文档了解更多方法和用法。
示例代码
-- -------------------- ---- ------- ----- ---- - ---------------------- -- ------ ----- --- - --- ---------------- ----------------- -- ----- ----- --------- - ------------------------ ------------- ----------------------- -- ---- ----- --- - ----------- ---------- ----- ------ - --- ---------------------- ----------- ------------- -------------------- -- ---- ----- -------- - --------------- ----------------------------------------- -------------- ----- -------- - ----------------------- ---------------------- ----- ------- - ------------------- ---------------------
总结
本文介绍了 date-utils 的基本使用方法，希望能够对前端工程师有所帮助。值得注意的是，date-utils 并不是唯一的日期时间处理库，例如 moment.js 也是一个优秀的选择，具体使用需结合项目需求，进行选择。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65145