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

# YEARBEGIN

> YiDA の YEARBEGIN 関数の使い方を解説します。指定した日付を、その日付が属する年の開始時刻に変換する方法を、フォームやワークフロー設計などの適用シーンとあわせて紹介します。

**YEARBEGIN** 関数は、指定した日付をその日付が属する年の開始時刻、すなわち `xxxx-01-01 00:00:00` に変換します。

## 対応する製品シーン

YEARBEGIN 関数は、YiDA の以下のシーンで利用できます。

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

## 形式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
YEARBEGIN(timestamp)
```

## 属性の説明

| **属性**    | **必須** | **説明**                         |
| --------- | ------ | ------------------------------ |
| timestamp | はい     | 日付のタイムスタンプ。日付コンポーネントを直接使用できます。 |

## 戻り値

| **戻り値のタイプ** | **説明**                                |
| ----------- | ------------------------------------- |
| timestamp   | その年の最初の日付のタイムスタンプ。日付コンポーネントに直接代入できます。 |

## 使用例

以下のように、`YEARBEGIN()` 関数を使用すると、日付が属する年の最初の時刻（`xxxx-01-01 00:00:00`）を取得できます。

## お試し

指定した日付が属する年の最初の日付を取得します。