简介
sacred-times 是一个用于处理时间和日期的轻量级 JavaScript 库。它简化了与时间和日期相关的任务，提供了易用的 API 和更好的性能，方便开发者创建、修改和格式化日期和时间。
安装
使用 npm 安装 sacred-times：
--- ------- ------------
引入
在 Node.js 中，通过以下方式引入 sacred-times：
----- ------ - ------------------------
在浏览器中，可以使用 CDN 或者直接下载包含 sacred-times 的 JavaScript 文件。
------- -----------------------------------------------------------------------
API
sacred-times 的 API 简单易用，支持链式调用。
获取日期和时间
-------------
返回当前日期和时间，例如：
--- --- -- ---- -------- -------- ------ -------- -----
---------------
返回今天的日期，例如：
--- --- -- ----
-------------------
返回昨天的日期，例如：
--- --- -- ----
------------------
返回明天的日期，例如：
--- --- -- ----
格式化日期和时间
------------------- --------
将日期和时间按照指定的格式进行格式化。
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（周六） |
例如：
----------------- ------- --------------
返回当前日期的年、月、日，例如：
----------
------------------------------- ----------- -----------
将字符串格式化为指定的日期时间格式：
---------- --------
修改日期和时间
---------------- ----------
将日期加上指定时间间隔，返回新的日期对象。
date 参数是一个 JavaScript Date 对象，或者是一个字符串，可以是标准的日期字符串，也可以自定义格式。
duration 参数是一个字符串，定义了要添加的时间量。格式为 <N> <unit>，其中 <N> 是一个数字，<unit> 是时间单位，可以是以下值之一：
| unit | 描述 |
|---|---|
| year | 年 |
| month | 月 |
| week | 周（7 天） |
| day | 日 |
| hour | 小时 |
| minute | 分钟 |
| second | 秒 |
| ms | 毫秒（默认值） |
例如：
----- -------- - -------------- ------- -- ------ ----------------------
输出明天的日期。
----- -------- - -------------- ------- -- ------- ----------------------
输出明年的日期。
----- ------------- - -------------- ------- --- --------- ---------------------------
输出半小时后的时间。
判断日期和时间
-----------------------
判断指定日期是否为周末，返回布尔值。
例如：
-------------------- -------- -- ---------
------------------------
判断指定年份是否为闰年，返回布尔值。
例如：
------------------------ -- -----
示例代码
----- ------ - ------------------------ -- --------- -------------------------- -- ------- ---------------------------- -- ------- -------------------------------- -- ------- ------------------------------- -- -------- ----------------------------- ------- --------------- -- ------------- ------------------------------------------- ----------- ------------ -- ----------- -------------------------- ------- -- ------- -- --------- -------------------------------- --------- -- ----------- -------------------------------------
总结
sacred-times 是一个非常实用的时间和日期处理库，它提供了简单易用的 API，可以大大简化开发者的工作。本文介绍了该库的安装和使用方法，以及常用 API 的使用示例。希望本文能够帮助开发者更好地使用 sacred-times。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/60066b5a51ab1864dac66f76