> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WORKDAY

> WORKDAY函数用于在宜搭平台中计算某日期在N个工作日后（前）的日期，支持多种场景如表单、流程设计等。通过设置开始时间、工作日天数及排除的节假日，可以灵活地生成所需的工作日日期。

**WORKDAY**函数用于获取某日期在N个工作日后（前）的日期。

## 支持产品场景

WORKDAY函数支持在宜搭的以下场景中使用。

* 表单（主表字段）
* 表单（业务关联规则）
* 表单（校验）
* 流程设计（校验规则）
* 流程设计（关联操作）
* 流程-节点
* 连接器

## 格式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
WORKDAY(start_time,days,holidays)
```

## 属性说明

| **属性**      | **是否必填** | **说明**                                                                                           |
| ----------- | -------- | ------------------------------------------------------------------------------------------------ |
| start\_time | 是        | 开始时间的时间戳，可以直接使用日期组件的值。                                                                           |
| days        | 是        | 工作日天数，最大支持设置50000，超过限制按0天处理。<br />**说明**：如果值为正数，则生成未来某工作日后的时间。如果值为负数，则生成过去的日期。如果值为小数，则默认按增加一天处理。 |
| holidays    | 否        | 计算排除的日期，日期格式为：`yyyy-MM-dd`。可以设置多个，多个日期之间用英文逗号分隔。<br />例如：可以将各种省、市、自治区、国家/地区的法定假日及非法定假日。          |

## 返回值

| **返回值类型** | **说明**                        |
| --------- | ----------------------------- |
| timestamp | 某日期在N个工作日后（前）的日期。可以直接赋值给日期组件。 |

## 使用示例

如下图所示，你可以使用`WORKDAY()`函数计算 15 个工作日后的时间点。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/gif/1703238498887-13af14a9-589b-4154-87d2-5afbdb4914d1.gif)
</Frame>
