前置条件
在使用 @told/work-hours 前，您需要先安装 Node.js 和 NPM。
什么是 @told/work-hours？
@told/work-hours 是一个可以帮助我们计算一段时间内的有效工作时长的 npm 包。这个包是开源的，可以在 GitHub 上找到详细的文档和代码。
如何安装 @told/work-hours？
您可以在您的项目目录下运行以下命令来安装 @told/work-hours：
npm install @told/work-hours
如何使用 @told/work-hours？
第一步：引入包
const workHours = require('@told/work-hours');第二步：使用 getWorkHours 函数
该函数需要 3 个参数：
start：一个 JavaScript 的Date类型，代表工作起始时间。end：一个 JavaScript 的Date类型，代表工作结束时间。options：计算工作时长的选项。
以下是一个使用 getWorkHours 函数的示例：
// 使用示例
const start = new Date('2022-01-01T08:00:00Z');
const end = new Date('2022-01-01T17:00:00Z');
const options = { weekdays: [1, 2, 3, 4, 5], startHour: 9, endHour: 17 };
const result = workHours.getWorkHours(start, end, options);
console.log(result);该示例计算了 2022 年 1 月 1 日早上 8 点到下午 5 点之间，除了周六和周日外的有效工作时长。
选项
以下是 getWorkHours 函数中可以使用的选项及其默认值：
{
weekdays: [1, 2, 3, 4, 5], // 工作日，例如 [1, 2, 3, 4, 5] 代表周一到周五
startHour: 9, // 工作起始小时，例如 9 代表早上 9 点
endHour: 17, // 工作结束小时，例如 17 代表下午 5 点
includeHolidays: false, // 是否包含节假日
holidays: [], // 节假日，每个元素是一个 JavaScript 的 Date 类型，代表一个节假日
timeZone: '+00:00', // 时区信息，例如 '+08:00' 代表北京时间
}返回值
函数 getWorkHours 的返回值是一个对象，包含以下两个属性：
hours：两个日期之间的有效工作小时数，可以是小数。minutes：两个日期之间的有效工作分钟数，以整数表示。
示例
以下是一个计算两段时间之间有效工作时长的完整示例：
-- -------------------- ---- ------- ----- ------ - --- ----------------------------- ----- ---- - --- ----------------------------- ----- ------ - --- ----------------------------- ----- ---- - --- ----------------------------- ----- ------- - - --------- --- -- -- -- --- ---------- -- -------- -- -- ----- ------- - ------------------------------ ----- --------- ----- ------- - ------------------------------ ----- --------- ------------------------------------- -- ----------------- - --- ----- ------------------------------------- -- ----------------- - --- ----- ----- --- - - ------ ------------- - -------------- -------- --------------- - --------------- -- ------------------------------- -- ------------- - --- -----
结论
使用 @told/work-hours 包可以方便地计算一段时间内的有效工作时长。为了获得更精准的结果，请选择合适的工作日，工作起始时间和结束时间，并按需选择是否包含节假日。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005519f81e8991b448cefb7