简介
sacred-times 是一个用于处理时间和日期的轻量级 JavaScript 库。它简化了与时间和日期相关的任务，提供了易用的 API 和更好的性能，方便开发者创建、修改和格式化日期和时间。
安装
使用 npm 安装 sacred-times：
npm install sacred-times
引入
在 Node.js 中，通过以下方式引入 sacred-times：
const sacred = require('sacred-times');在浏览器中，可以使用 CDN 或者直接下载包含 sacred-times 的 JavaScript 文件。
<script src="https://unpkg.com/sacred-times/dist/sacred-times.min.js"></script>
API
sacred-times 的 API 简单易用，支持链式调用。
获取日期和时间
sacred.now();
返回当前日期和时间，例如：
Sun May 23 2021 22:17:25 GMT+0800 (China Standard Time)
sacred.today();
返回今天的日期，例如：
Sun May 23 2021
sacred.yesterday();
返回昨天的日期，例如：
Sat May 22 2021
sacred.tomorrow();
返回明天的日期，例如：
Mon May 24 2021
格式化日期和时间
sacred.format(date, format);
将日期和时间按照指定的格式进行格式化。
date 参数是一个 JavaScript Date 对象，或者是一个字符串，可以是标准的日期字符串，也可以自定义格式。
format 参数是一个字符串，定义了要显示的格式。常用的格式如下：
| 符号 | 描述 | 示例 |
|---|---|---|
| YYYY | 年份 | 2021、99 |
| MM | 月份（两位数） | 01、12 |
| M | 月份（一位数） | 1、12 |
| DD | 日期（两位数） | 01、31 |
| D | 日期（一位数） | 1、31 |
| hh | 小时（两位数） | 00、23 |
| h | 小时（一位数） | 0、23 |
| mm | 分钟（两位数） | 00、59 |
| m | 分钟（一位数） | 0、59 |
| ss | 秒钟（两位数） | 00、59 |
| s | 秒钟（一位数） | 0、59 |
| SSS | 毫秒钟（三位数） | 000、999 |
| A | 上午/下午 | AM、PM |
| a | 上午/下午 | am、pm |
| d | 一周的第几天 | 0（周日）、6（周六） |
例如：
sacred.format(new Date(), 'YYYY-MM-DD');
返回当前日期的年、月、日，例如：
2021-05-23
sacred.format('20210523101220', 'YYYY-MM-DD hh:mm:ss');将字符串格式化为指定的日期时间格式：
2021-05-23 10:12:20
修改日期和时间
sacred.add(date, duration);
将日期加上指定时间间隔，返回新的日期对象。
date 参数是一个 JavaScript Date 对象，或者是一个字符串，可以是标准的日期字符串，也可以自定义格式。
duration 参数是一个字符串，定义了要添加的时间量。格式为 <N> <unit>，其中 <N> 是一个数字，<unit> 是时间单位，可以是以下值之一：
| unit | 描述 |
|---|---|
| year | 年 |
| month | 月 |
| week | 周（7 天） |
| day | 日 |
| hour | 小时 |
| minute | 分钟 |
| second | 秒 |
| ms | 毫秒（默认值） |
例如：
const tomorrow = sacred.add(new Date(), '1 day'); console.log(tomorrow);
输出明天的日期。
const nextYear = sacred.add(new Date(), '1 year'); console.log(nextYear);
输出明年的日期。
const halfHourLater = sacred.add(new Date(), '30 minute'); console.log(halfHourLater);
输出半小时后的时间。
判断日期和时间
sacred.isWeekend(date);
判断指定日期是否为周末，返回布尔值。
例如：
sacred.isWeekend(new Date()); // 当前日期是否为周末
sacred.isLeapYear(year);
判断指定年份是否为闰年，返回布尔值。
例如：
sacred.isLeapYear(2000); // 是否为闰年
示例代码
-- -------------------- ---- ------- ----- ------ - ------------------------ -- --------- -------------------------- -- ------- ---------------------------- -- ------- -------------------------------- -- ------- ------------------------------- -- -------- ----------------------------- ------- --------------- -- ------------- ------------------------------------------- ----------- ------------ -- ----------- -------------------------- ------- -- ------- -- --------- -------------------------------- --------- -- ----------- -------------------------------------
总结
sacred-times 是一个非常实用的时间和日期处理库，它提供了简单易用的 API，可以大大简化开发者的工作。本文介绍了该库的安装和使用方法，以及常用 API 的使用示例。希望本文能够帮助开发者更好地使用 sacred-times。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066b5a51ab1864dac66f76