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

# YEAR

> YiDAの関数YEARの使い方を解説します。指定した日付から年を数値として取得する構文、属性、戻り値、使用例を紹介し、フォームやワークフロー設計など複数のシナリオでの活用方法を説明します。

**YEAR** 関数は、指定した日付の年を返します。

## 対応シナリオ

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

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

## 構文

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

## 属性

| **属性** | **必須** | **説明**    |
| ------ | ------ | --------- |
| date   | はい     | 日付オブジェクト。 |

## 戻り値

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

## 例

以下のとおり、`MONTH()` 関数を使用して、ユーザーが選択した日付から月を取得します。

## 試してみる

指定した日付の月を、1 から 12 までの整数として返します。