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

> The TEXT function formats a number into text using a specified format. It supports multiple product scenarios such as forms and workflow design. By specifying the num and pattern parameters, you can format numbers or date-time values.

The **TEXT** function formats a number into text using a specified format.

## Supported Product Scenarios

Use the TEXT function in the following YiDA scenarios:

* Form (main table fields)
* Form (business association rules)
* Form (validation)
* Workflow design (validation rules)
* Workflow design (association actions)
* Integration and automation
* Workflow node
* Connector

## Syntax

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

## Attributes

| **Attribute** | **Required** | **Description**       |
| ------------- | ------------ | --------------------- |
| num           | Yes          | The number to format. |
| pattern       | Yes          | The target format.    |

## Return Value

| **Return value type** | **Description**        |
| --------------------- | ---------------------- |
| Text                  | The formatted content. |

## Examples

* Format a regular number:

The formula returns `1,234,567,890`.

* Format a date-time value:

The formula returns `2023-12-19 17:26:07`.

## Try It Out

Format a number into text using a specified format.