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

# 使用AI表格TEXT函数

> 📌更多函数可以参考公式函数大全

> 📌更多函数可以参考[公式函数大全](/zh/aitable/formulas/function-reference)

# 函数基础介绍

**TEXT**是AI表格中常用的函数，用于将数字转换为按照指定格式显示的文本。它允许用户定义数字的显示方式，包括日期、时间、货币、百分比等格式。

| **格式与占位符**​ | **说明**​             | **举例**​                                                                            |
| ----------- | ------------------- | ---------------------------------------------------------------------------------- |
| #           | 数字占位符，用于自定义数字格式     | TEXT(34.56,"##.#")=34.6 TEXT(123.456,"##.##")=123.6  TEXT(78.901,"###.###")=78.901 |
| 0           | 数字补位符，用于自定义数字格式     | TEXT(56.7,"0.00")=56.70 TEXT(89.12,"0.00")=89.12 TEXT(3.14,"000.00")=003.14        |
| ,           | 千位分隔符，在 # 或者 0 之间使用 | TEXT(123456,"0,0")=123,456                                                         |
| %           | 百分号，需与 # 或者 0 结合使用  | TEXT(50,"0%")=5000%                                                                |
| YYYY        | 年份全称                | TEXT("2023-5-20","YYYY")=2023 TEXT("2023-5-20","YYYY年")=2023年                      |
| YY          | 年份缩写                | TEXT("2023-5-20","YY")=23 TEXT("2023-5-20","YY年")=23年 TEXT("2023-5-20","Y")=23     |
| MMM         | 月份全称                | TEXT("2023-5-20","MMM")=5月                                                         |
| MM          | 月份数字全写              | TEXT("2023-520","YYYY/MM")=2023/05 TEXT("2023-5-20","MM月")=05月                     |
| M           | 月份数字简写              | TEXT("2023-5-20","M")=5    TEXT("2023-5-20","M月")=5月                               |
| DD          | 日全写                 | TEXT("2023-5-1","DD")=01 TEXT("2023-5-1","DD日")=01日                                |
| D           | 日简写                 | TEXT("2023-5-1","D")=1       TEXT("2023-5-1","D日")=1日                              |
| DDDD        | 星期全称                | TEXT("2023-5-1","DDDD")=星期一                                                        |
| DDD         | 星期简称                | TEXT("2023-5-1","DDD")=周一                                                          |
| hh          | 小时                  | TEXT("19:45","hh")=19                                                              |
| mm          | 分钟                  | TEXT("19:45","hh:mm")=19:45                                                        |
| ss          | 秒钟                  | TEXT("19:45:30","ss")=30                                                           |

### **基本语法**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
TEXT(值, 格式文本)
```

* **值**：需要转换为文本的数字或日期。
* **格式文本**：定义值的显示格式的文本字符串。

### **示例**

#### **示例 1：将数字格式化为货币**

假设\[字段1]第一行的内容为**1234.567**。

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
=TEXT([字段1], "$#,##0.00")
```

结果为：**\$1,234.57**（因为数值被格式化为带有美元符号的两位小数）

#### **示例 2：将日期格式化为特定格式**

假设\[字段1]第一行的内容为**2023-03-15**。

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
=TEXT([字段1], "mm/dd/yyyy")
```

结果为：**03/15/2023**（因为日期被格式化为月/日/年的形式）

通过**TEXT**函数，您可以轻松地将数字或日期转换为特定格式的文本，以便更好地满足展示和报告的需求。这在生成报表、标签或其他需要特定格式的输出时非常有用。

# 常见问题

* 问：如果函数返回值同时包含日期和时间 \[yyyy-mm-dd hh:mm]，如何仅保留日期 \[yyyy-mm-dd]？

  答：方法 1：使用 TEXT() 函数进行格式转换。新建公式字段，输入**TEXT(\[待调整的返回值], "YYYY-MM-DD")** 即可。方法 2：双击当前公式字段，将字段格式设置为日期，并在日期格式中调整为所需格式即可。
* 问：为什么使用 TEXT() 函数计算出的结果为数字时，却在其他函数中计算会出现错误？

  答：TEXT() 函数的计算结果是以文本格式呈现的。若需在其他函数中进行数值计算，可以先使用 SUM() 或 ABS() 等函数将结果转换为数值格式后再引用或计算。