> ## 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.

# WEEKNUM

> WEEKNUM函数用于获取指定日期是当年的第几周，支持在宜搭表单、流程设计等多种场景中使用。该函数接受时间对象作为参数，并可选设置每周的起始时间为周日或周一，默认为周日。

**WEEKNUM**函数获取指定日期是当年的第几周。

## 支持产品场景

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

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

## 格式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
WEEKNUM(date, return_type)
```

## 属性说明

| **属性**       | **是否必填** | **说明**                                                         |
| ------------ | -------- | -------------------------------------------------------------- |
| date         | 是        | 时间对象。                                                          |
| return\_type | 否        | 每周的起始时间。取值：<br />• 1：表示每周从周日开始<br />• 2：表示每周从周一开始<br />默认值为 1。 |

## 返回值

| **返回值类型** | **说明**  |
| --------- | ------- |
| 数字        | 返回日期周数。 |

## 使用示例

如下图所示，你可以使用`WEEKNUM()`函数获取指定日期的周数。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1703166941058-5f5e047e-6a64-4dcb-91b6-722b61ba35ad.png)
</Frame>

## 体验

返回特定日期的周数。例如，包含 1 月 1 日为该年的第 1 周，其编号为第 1 周。