> ## 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函数用于将数字格式化成指定格式文本，支持多种产品场景如表单、流程设计等。通过指定num和pattern参数，可以实现对数字或时间内容的格式化转换。

**TEXT**函数用于将数字格式化成指定格式文本。

## 支持产品场景

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

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

## 格式

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

## 属性说明

| **属性**  | **是否必填** | **说明**        |
| ------- | -------- | ------------- |
| num     | 是        | 需要进行格式化转换的数字。 |
| pattern | 是        | 指定格式。         |

## 返回值

| **返回值类型** | **说明**     |
| --------- | ---------- |
| 文本        | 格式化完成后的内容。 |

## 使用示例

* 格式化普通数字内容：

下图中公式的执行结果为：`1,234,567,890`。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1702978848279-48cea931-5b7f-4934-ad16-2c877f27bb1d.png)
</Frame>

* 格式化时间内容：

下图中公式的执行结果为：`2023-12-19 17:26:07`。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1702979053646-63b29572-68f5-4aed-82e0-40e52ea579d5.png)
</Frame>

## 体验

将数字格式化成指定格式文本。