简介
workdates 是一个使用 JavaScript 编写的可轻松计算工作日的 npm 包。该包提供了广泛的功能，可以处理如计算两个日期之间的工作天数、排除周末和假期、列出特定范围内的工作日等等。
安装与使用
首先，在你的项目中安装 workdates NPM 包, 可以通过以下方式：
npm install workdates --save
导入 workdates 包
在节点应用中，可以通过 require 来导入该包，并进行专业化设置:
const workdates = require('workdates');在浏览器端，可以通过 CDN 导入该包，并在全局范围内使用：
<script src="https://cdn.jsdelivr.net/npm/workdates"></script>
要在 HTML 中使用它，请确保 CDN 链接符合 SOP 限制。
基础使用
支持以下的常见用例：
- 计算两个日期之间的工作日
- 导入假期，以便在日期计算中排除它们
- 验证一个日期是否是工作日
- 从一个日期开始，得到下一个工作日
示例代码：
-- -------------------- ---- ------- ----- --------- - --------------------- ----- --------- - --- ---------- -- ---- ----- ------- - --- ---------- -- ---- ----- -------- - - --- ---------- -- ---- --- ---------- -- --- -- ----- -------- - --------------------------------------- -------- ---------- ---------------------- -- - --- --- -- ----- --- --- -- ----- --- --- -- ----- --- --- -- ---- -
在上面的示例中，我们计算了 2021 年 6 月 12 日到 2021 年 6 月 18 日之间的工作日。然后，我们将公共假期作为参数传递给计算方法中，以便在计算两个日期之间的工作日时从中排除这些日期。
API 参考
以下部分提供了 workdates 包的 API 文档和解释。
getWorkdaysBetween(startDate, endDate, holidays)
计算 startDate 到 endDate 之间的工作日。假期作为参数holidays 传入，如下所示：
const workdays = workdates.getWorkdaysBetween(startDate, endDate, holidays);
getBusinessDaysCount(startDate, endDate, holidays)
计算 endDate 与 startDate 之间的“真”工作日数量，“真” 工作日超出了 24 小时的工作日时间，忽略非工作日和假期。
const numOfWorkingDays = workdates.getBusinessDaysCount(startDate, endDate, holidays);
addWorkdaysToDate(startDate, numOfWorkdays, holidays)
计算给定日期 startDate 之后的 numOfWorkdays 工作日，返回新日期。
const newDate = workdates.addWorkdaysToDate(startDate, numOfWorkdays, holidays);
isWeekday(date)
如果给定的 date (ISO 8601 格式) 是工作日，则返回true，否则返回 false。
const isWeekday = workdates.isWeekday('2021-05-01');总结
workdates 是一个强大的 JavaScript 工具，可用于处理日期和工作日计算。它可以轻松地将工作日计算集成到你的应用程序中，帮助你完成更准确的工作计划，比如办公室、学校、服务等等。了解使用 workdates 简单的方式，有助于你更好地运用其能力，并在其基础上进一步创造更有价值的业务部分。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056bdc81e8991b448e5861