# **WORKDAY**

返回起始日期之前或之后相隔指定工作日的某一工作日的日期值。

## 语法{#grammar}

WORKDAY(**dateStart**, **days**, **\[holidays]**, **\[nonholidays]**)

- **dateStart**：必需，起始日期
- **days**：必需，为起始日期之前或之后不含周末及节假日的天数，值为正则产生未来日期；值为负则产生过去日期
- **holidays**：可选，表示需要从工作日历中排除的日期值，该参数是由日期所构成的数组常量
- **nonholidays**：可选，表示需要从周末日历中排除的日期值，该参数是由日期所构成的数组常量

**示例地址：** [WORKDAY](https://demo.succbi.com/v5/bi/workday)

## 示例{#example}

1. `WORKDAY('20201223',1)` 返回一个工作日后的日期，返回日期`2020-12-24`
2. `WORKDAY('20201223',-1)` 返回一个工作日前的日期，返回日期`2020-12-22`
3. `WORKDAY('20201223',2,'20201225')` 返回二个工作日后的日期，其中12月25日为节假日，返回日期`2020-12-28`
4. `WORKDAY('20201223',3,'','20201226')` 返回三个工作日后的日期，其中12月26日为工作日，返回日期`2020-12-26`
5. `WORKDAY('20201223',3,'20201225','20201226')` 返回三个工作日后的日期，其中12月25日为节假日，12月26日为工作日，返回日期`2020-12-28`
6. `WORKDAY('20201223',2,ARR('20201224','20201225'),ARR('20201226','20201227'))` 返回二个工作日后的日期，其中12月24日、12月25日为节假日，12月26日、12月27日为工作日，返回日期`2020-12-27`
7. `WORKDAY("2020-7-16",3)` 日期格式为yyyy-dd-mm，返回日期`2020-07-21`
8. `WORKDAY("2020.7.16",3)` 日期格式为yyyy.dd.mm，返回日期`2020.07.21`
9. `WORKDAY("2020/7/16",3)` 日期格式为yyyy/dd/mm，返回日期`2020/07/21`
10. `WORKDAY("2020 7 16",3)` 日期格式为yyyy dd mm，返回日期`2020 07 21`
11. `WORKDAY('20201223',1.8)` 返回1.8个工作日后的日期（向下取整为1），返回日期`2020-12-24`
12. `WORKDAY('20201223',-0.1)` 返回0.1个工作日前的日期（向下取整为-1），返回日期`2020-12-22`
13. `WORKDAY(A1,1)` 返回`A1`一个工作日后的日期