简体中文 | English |

dayjs-plugin-workDays

一个基于 day.js 的工作日插件

安装

npm install  dayjs-plugin-workdays --save

使用方法

import workDays from "dayjs-plugin-workdays";
dayjs.extend(workDays);
dayjs().workDays(date, options);

参数

参数date

类型 Date 传入日期或dayjs对象。 将计算到日期的工作日例如：dayjs("2024/01/01").workDays("2024/01/31", options)就会计算2024/01/01到2024/01/31的工作日。

参数 options

需要传入一个对象

| 属性名 | 类型 | 默认值 | 必填 | 描述 |
| ---------------------- | ------- | -------- | ---- | -------------------------------------------------------------------------------- |
| options.vacationDates | Date[] | [] | 否 | 假期日期，即除了周末外的节假日日期 |
| options.weekendDays | Int[] | [0,6] | 否 | 默认值[0,6]也就是周六和周日，周几休息就传入周几的代码，如只有周日则传入[0]，如果周三额外休息传入[0,2,6] |
| options.adjustWorkDates | Date[] | [] | 否 |万恶调休！，传入一个周末日期，这个日期将不会被识别为假期，而是加入工作日；如果与options.vacationDates日期冲突，则优先级较高 |

返回值 returns

将会返回一个对象

| 属性名 | 类型 | 描述 |
| --------------- | ------- | -------------------------------------------------- |
| returns.restDays | Date[] | 休息日，即范围内所有周末和假日的日期 |
| returns.workDays | Date[] | 工作日，即范围内所有普通工作日和调休工作日 |
| returns.weekendDays | Date[] | 周末，即范围内所有周末日期，会被包含在returns.restDays内 |
| returns.vacationDays | Date[] | 范围内所有假日日期，会被包含在returns.restDays内 |
| returns.adjustWorkDays | Date[] | 范围内所有的调休工作日，会被包含在returns.workDays内 |

使用示例

import dayjs from "dayjs";
import workDays from "dayjs-plugin-workdays";
dayjs.extend(workDays);
const options = {
  vacationDates: [
    "2024/05/01",
    "2024/05/02",
    "2024/05/03",
    "2024/05/04",
    "2024/05/05",
  ],
  adjustWorkDdates: ["2024/05/11"],
};
const result = dayjs("2024/5/1").workDays("2024/5/31", options);
console.log(result);

输出

{
  restDays: [
    '2024-05-01', '2024-05-02',
    '2024-05-03', '2024-05-04',
    '2024-05-05', '2024-05-12',
    '2024-05-18', '2024-05-19',
    '2024-05-25', '2024-05-26'
  ],
  workDays: [
    '2024-05-06', '2024-05-07',
    '2024-05-08', '2024-05-09',
    '2024-05-10', '2024-05-11',
    '2024-05-13', '2024-05-14',
    '2024-05-15', '2024-05-16',
    '2024-05-17', '2024-05-20',
    '2024-05-21', '2024-05-22',
    '2024-05-23', '2024-05-24',
    '2024-05-27', '2024-05-28',
    '2024-05-29', '2024-05-30',
    '2024-05-31'
  ],
  weekendDays: [
    '2024-05-04',
    '2024-05-05',
    '2024-05-12',
    '2024-05-18',
    '2024-05-19',
    '2024-05-25',
    '2024-05-26'
  ],
  vacationDays: [ '2024-05-01', '2024-05-02', '2024-05-03' ],
  adjustWorkDays: [ '2024-05-11' ]
}