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

# TEXT

> TEXT関数は数値を指定した形式のテキストに整形します。YiDAのフォームや作業フロー設計など複数のシナリオに対応し、num と pattern パラメータで数値や日時のフォーマット指定が可能です。

**TEXT** 関数は、数値を指定した形式のテキストに整形します。

## 対応する製品シナリオ

TEXT関数は、以下のYiDAシナリオで使用できます。

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

## 構文

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
TEXT(num, pattern)
```

## 属性

| **属性**  | **必須** | **説明**     |
| ------- | ------ | ---------- |
| num     | はい     | 整形する数値。    |
| pattern | はい     | 目的のフォーマット。 |

## 戻り値

| **戻り値の型** | **説明**     |
| --------- | ---------- |
| テキスト      | 整形後のコンテンツ。 |

## 例

* 通常の数値を整形する場合：

数式は `1,234,567,890` を返します。

* 日時の値を整形する場合：

数式は `2023-12-19 17:26:07` を返します。

## お試し

数値を指定した形式のテキストに整形します。