Documentation Index
Fetch the complete documentation index at: https://help.teable.ai/llms.txt
Use this file to discover all available pages before exploring further.
公式字段用于根据同一条记录里的其他字段自动计算结果。它可以处理数学运算、文本拼接、日期计算和条件判断，适合把重复计算规则固化到字段中。
适用场景
| 场景 | 适合内容 |
|---|
| 自动计算 | 根据数量、单价、折扣等字段计算总价、利润或得分 |
| 文本处理 | 拼接文本、截取内容，或按分隔符提取信息 |
| 日期处理 | 计算日期差、判断时间范围，或生成未来日期 |
| 条件判断 | 根据条件返回不同结果，比如状态、提示或分类 |
基础概念
数据类型
编写公式前，先确认参与计算的字段类型。不同类型支持的操作和函数不同。
| 类型 | 说明 | 常见用法 |
|---|
| 数字 | 整数或小数 | 四则运算、汇总、比较大小 |
| 文本 | 字符串值 | 拼接、截取、替换、分割 |
| 日期 | 日期或日期时间 | 计算间隔、比较早晚 |
| 布尔值 | TRUE 或 FALSE | 条件判断、逻辑运算 |
引用字段
在公式中，可以通过字段名称引用其他字段的值。字段名称需要写在 {} 中，并与实际字段名保持一致：
运算符
| 运算符 | 用途 |
|---|
+ | 计算数值的和，或连接字符串 |
- | 计算数值的差 |
* | 计算数值的积 |
/ | 计算数值的商 |
% | 计算余数 |
常用写法
常用函数
函数用于执行特定操作。比如 SUM 计算总和，LEFT 从文本开头提取字符，TEXTBEFORE 按分隔符提取前半段文本，TEXTSPLIT 按分隔符拆分文本。
更多函数请参阅函数速查表。
文本处理
| 操作 | 函数示例 | 说明 |
|---|
| 连接文本 | &、CONCATENATE | 将两个或多个文本连接起来 |
| 提取文本 | LEFT、RIGHT、MID、TEXTBEFORE | 提取字符串的一部分 |
| 拆分文本 | TEXTSPLIT | 按指定分隔符拆成多个值 |
逻辑判断
IF 函数可以根据条件返回不同值。格式如下：
IF(condition, value_if_true, value_if_false)
BLANK() 进行比较。比如 IF({重量}=BLANK(), 1, 2) 会在数字字段为空时返回 1，否则返回 2。
复杂表达式
复杂公式可以同时包含多个函数、字段引用和运算符。使用括号可以控制计算顺序：
({单价} * {数量}) * (1 - {折扣})
结果显示与维护
格式化和交互展现
公式结果也可以继续使用格式化和交互展现配置，比如显示为百分比、进度条或图标样式。可配置项会根据公式结果类型变化。
调试与优化
- 检查数据类型：确认操作和函数使用了正确的数据类型。
- 验证字段引用：确认字段名称写法正确。
- 逐步检查：把复杂公式拆成较小的部分分别测试。
- 避免重复计算：如果同一个计算会在多处使用，可以考虑把结果保存为单独字段。
