> ## 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関数は指定された日付が年内で何週目に該当するかを返します。YiDAのフォームやワークフロー設計など複数のシナリオで利用でき、週の開始日を日曜または月曜から選択可能です。

**WEEKNUM** 関数は、指定された日付が年内で何週目に該当するかを返します。

## 対応シナリオ

WEEKNUM 関数は、以下の YiDA シナリオで対応しています。

* フォーム(メインフォームフィールド)
* フォーム(業務関連ルール)
* フォーム(検証)
* ワークフロー設計(検証ルール)
* ワークフロー設計(関連アクション)
* 統合と自動化
* フローノード
* コネクタ

## 構文

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

## 属性

| **属性**       | **必須** | **説明**                                                                |
| ------------ | ------ | --------------------------------------------------------------------- |
| date         | 必須     | 時刻オブジェクト。                                                             |
| return\_type | 任意     | 週の開始日。値:<br />• 1: 週は日曜から始まります。<br />• 2: 週は月曜から始まります。<br />デフォルト: 1。 |

## 戻り値

| **戻り値のタイプ** | **説明**  |
| ----------- | ------- |
| Number      | 日付の週番号。 |

## 例

以下の図に示すように、`WEEKNUM()` 関数を使用して、指定された日付の週番号を取得します。

## 試してみる

指定された日付の週番号を返します。たとえば、1月1日を含む週は年の第1週となり、週番号は1となります。