函数速查表 - Teable

函数速查表用于快速查找可用函数、参数、输出类型和示例。编写公式时，可以按函数类别定位需要的函数。

数值函数

数值函数用于数学运算、统计计算和数字格式处理。

函数名称	描述	输入	输出	示例
SUM	将数字加在一起。相当于 number1 + number2 + …	`number1, [number2, ...]`	Number	`SUM(100, 200, 300) => 600`
AVERAGE	返回数字的平均值。	`number1, [number2, ...]`	Number	`AVERAGE(100, 200, 300) => 200`
MAX	返回给定数字中的最大值。	`number1, [number2, ...]`	Number	`MAX(100, 200, 300) => 300`
MIN	返回给定数字中的最小值。	`number1, [number2, ...]`	Number	`MIN(100, 200, 300) => 100`
ROUND	按 `precision` 指定的小数位数四舍五入。	`value, [precision]`	Number	`ROUND(1.99, 0) => 2` `ROUND(16.8, -1) => 20`
ROUNDUP	总是向上四舍五入，即远离零。	`value, [precision]`	Number	`ROUNDUP(1.1, 0) => 2` `ROUNDUP(-1.1, 0) => -2`
ROUNDDOWN	总是向下四舍五入，即朝向零。	`value, [precision]`	Number	`ROUNDDOWN(1.9, 0) => 1` `ROUNDDOWN(-1.9, 0) => -1`
CEILING	返回大于或等于该值的最接近的整数倍数。	`value, [significance]`	Number	`CEILING(2.49) => 3` `CEILING(2.49, 1) => 2.5`
FLOOR	返回小于或等于该值的最接近的整数倍数。	`value, [significance]`	Number	`FLOOR(2.49) => 2` `FLOOR(2.49, 1) => 2.4`
EVEN	返回大于或等于指定值的最小偶数。	`value`	Number	`EVEN(0.1) => 2` `EVEN(-0.1) => -2`
ODD	将正值四舍五入到最接近的奇数，将负值四舍五入到最接近的奇数。	`value`	Number	`ODD(0.1) => 1` `ODD(-0.1) => -1`
INT	返回数值的整数部分，向负无穷取整。	`value`	Number	`INT(1.9) => 1` `INT(-1.9) => -2`
ABS	返回绝对值。	`value`	Number	`ABS(-1) => 1`
SQRT	返回非负数的平方根。	`value`	Number	`SQRT(4) => 2`
POWER	计算指定的基数到指定的功率。	`value`	Number	`POWER(2) => 4`
EXP	计算欧拉数（e）的指定次幂。	`value`	Number	`EXP(0) => 1` `EXP(1) => 2.718`
LOG	按指定基数计算值的对数。如果未指定，基数默认为 10。	`value, [base=10]`	Number	`LOG(100) => 2` `LOG(1024, 2) => 10`
MOD	返回将第一个参数除以第二个后的余数。	`value, divisor`	Number	`MOD(9, 2) => 1` `MOD(9, 3) => 0`
VALUE	将文本字符串转换为数字。	`text`	Number	`VALUE("$1,000,000") => 1000000`

文本函数

文本函数用于连接、查找、替换、截取和拆分字符串。

函数名称	描述	输入	输出	示例
CONCATENATE	连接多种值类型参数为单一文本值。	`text1, [text2, ...]`	Text	`CONCATENATE("Hello ", "Teable") => Hello Teable`
FIND	在指定文本中查找子字符串的位置。如果未找到子字符串，则结果为 0。	`stringToFind, whereToSearch, [startFromPosition]`	Number	`FIND("Teable", "Hello Teable") => 7`
SEARCH	在指定文本中查找子字符串的位置。与 `FIND` 类似，但未找到子字符串时返回空值。	`stringToFind, whereToSearch, [startFromPosition]`	Text or Empty	`SEARCH("Teable", "Hello Teable") => 7`
MID	提取从指定位置开始的指定数量的子字符串。	`text, whereToStart, count`	Text	`MID("Hello Teable", 6, 6) => "Teable"`
LEFT	提取字符串开始的指定数量的字符。	`text, count`	Text	`LEFT("2023-09-06", 4) => "2023"`
RIGHT	提取字符串结束的指定数量的字符。	`text, count`	Text	`RIGHT("2023-09-06", 5) => "09-06"`
REPLACE	用替换文本替换从开始字符开始的指定数量的字符。	`text, whereToStart, count, replacement`	Text	`REPLACE("Hello Table", 7, 5, "Teable") => "Hello Teable"`
REGEXP_REPLACE	使用替换文本替换匹配正则表达式的所有子字符串。	`text, regular_expression, replacement`	Text	`REGEXP_REPLACE("Hello Table", "H.* ", "") => "Teable"`
SUBSTITUTE	用新文本替换旧文本。可以指定索引号来替换旧文本的特定出现。如果未指定索引号，则将替换旧文本的所有出现。	`text, oldText, newText, [index]`	Text	`SUBSTITUTE("Hello Table", "Table", "Teable") => "Hello Teable"`
TEXTBEFORE	返回指定分隔符之前的文本内容。	`text, delimiter`	Text	`TEXTBEFORE("20, 04, 79", ",") => "20"`
TEXTSPLIT	按指定分隔符拆分文本，并返回多个文本值。	`text, delimiter`	Array	`TEXTSPLIT("20, 04, 79", ",") => ["20", " 04", " 79"]`
LOWER	将字符串转为小写。	`text`	Text	`LOWER("Hello Teable") => "hello teable"`
UPPER	将字符串转为大写。	`text`	Text	`UPPER("Hello Teable") => "HELLO TEABLE"`
REPT	将字符串重复指定的次数。	`text, number`	Text	`REPT("Hello!") => "Hello!Hello!Hello!"`
TRIM	去除字符串开始和结束的空白字符。	`text`	Text	`TRIM(" Hello ") => "Hello"`
LEN	计算字符串的字符数。	`text`	Number	`LEN("Hello") => 5`
T	如果参数是文本，则返回该参数，否则返回空。	`value`	Text or Empty	`T(“Hello”) => “Hello”` `T(100) => null`
ENCODE_URL_COMPONENT	为构造 URL 或 URI，把部分字符替换为编码等效项。不会编码以下字符：- _ . ~	`value`	Text	`ENCODE_URL_COMPONENT("Hello Teable") => "Hello%20Teable"`

逻辑函数

逻辑函数用于条件判断和逻辑运算，比如 IF、AND、OR。

函数名称	描述	输入	输出	示例
IF	如果逻辑参数为真，则返回 `value1`，否则返回 `value2`。也可用于嵌套判断和检查单元格是否为空。	`logical, value1, value2`	String \| Number \| Boolean \| Datetime	`IF(2 > 1, "A", "B") => "A"` `IF(2 > 1, TRUE, FALSE) => TRUE`
SWITCH	根据输入表达式匹配一组可能的值，并返回对应结果。没有匹配项时，可以返回默认值。很多情况下可替代嵌套 `IF`。	`expression, [pattern, result]..., [default]`	String \| Number \| Boolean \| Datetime	`SWITCH("B", "A", "Value A", "B", "Value B", "Default Value") => "Value B"`
AND	如果所有参数都为真，则返回真；否则返回假。	`logical1, [logical2, ...]`	Boolean	`AND(1 < 2, 5 > 3) => true` `AND(1 < 2, 5 < 3) => false`
OR	如果任意一个参数为真，则返回真。	`logical1, [logical2, ...]`	Boolean	`OR(1 < 2, 5 < 3) => true` `OR(1 > 2, 5 < 3) => false`
XOR	如果有奇数个参数为真，则返回真。	`logical1, [logical2, ...]`	Boolean	`XOR(1 < 2, 5 < 3, 8 < 10) => false` `XOR(1 > 2, 5 < 3, 8 < 10) => true`
NOT	反转其参数的逻辑值。	`boolean`	Boolean	`NOT(1 < 2) => false` `NOT(1 > 2) => true`
BLANK	返回一个空值，也可用于判断字段是否为空。	`-`	null	`BLANK() => null` `IF({重量}=BLANK(), 1, 2) => 1`
ERROR	返回一个错误值。	`message`	Error	`IF(2 > 3, "Yes", ERROR("Calculation")) => "#ERROR: Calculation"`
IS_ERROR	如果表达式引起错误，则返回真。	`expr`	Boolean	`IS_ERROR(ERROR()) => true`

日期函数

日期函数用于处理和转换日期时间，比如获取当前日期、计算日期差、判断日期先后。

函数名称	描述	输入	输出	示例
TODAY	返回当前日期。	`-`	Datetime	`TODAY() => "2023-09-08 00:00"`
NOW	返回当前的日期和时间。	`-`	Datetime	`NOW() => "2023-09-08 16:50"`
YEAR	返回日期的四位数字年份。	`date`	Number	`YEAR("2023-09-08") => 2023`
MONTH	返回日期的月份，作为1（1月）到12（12月）之间的数字。	`date`	Number	`MONTH("2023-09-08") => 9`
WEEKNUM	返回年份中的周数。	`date`	Number	`WEEKNUM("2023-09-08") => 36`
WEEKDAY	返回一周中的第几天，结果为0到6之间的整数。可以提供第二个参数（“星期日”或“星期一”）指定一周从哪一天开始。	`date, [startDayOfWeek]`	Number	`WEEKDAY("2023-09-08", "Monday") => 5`
DAY	返回日期的月份中的日期，作为1-31之间的数字。	`date`	Number	`DAY("2023-09-08") => 8`
HOUR	返回日期的小时数，作为0（12:00am）到23（11:00pm）之间的数字。	`date`	Number	`HOUR("2023-09-08 16:50") => 16`
MINUTE	返回日期的分钟，作为0到59之间的整数。	`date`	Number	`MINUTE("2023-09-08 16:50") => 50`
SECOND	返回日期的秒数，作为0到59之间的整数。	`date`	Number	`SECOND("2023-09-08 16:50:30") => 30`
FROMNOW	计算当前日期与另一个日期之间的天数。	`date, unit`	Number	`FROMNOW({Date}, "day") => 25`
TONOW	计算当前日期与另一个日期之间的天数。	`date, unit`	Number	`TONOW({Date}, "day") => 25`
DATETIME_DIFF	返回指定单位的日期时间差异，默认单位是秒。	`date1, date2, [unit]`	Number	`DATETIME_DIFF("2022-08-01", "2023-09-08", "day") => 403`
WORKDAY	返回从开始日期起算的工作日，不包括指定假期。	`date, count, [holidayStr]`	Datetime	`WORKDAY("2023-09-08", 200) => "2024-06-14 00:00:00"`
WORKDAY_DIFF	返回 `date1` 和 `date2` 之间的工作日数。工作日不包括周末和可选假日列表，假日列表使用 ISO 日期并用逗号分隔。	`date1, date2, [holidayStr]`	Number	`WORKDAY_DIFF("2023-06-18", "2023-10-01") => 75`
IS_SAME	按指定单位比较两个日期是否相同。相同返回 `true`，否则返回 `false`。	`date1, date2, [unit]`	Boolean	`IS_SAME("2023-09-08", "2023-09-10") => false`
IS_AFTER	判断 `date1` 是否晚于 `date2`。如果是，返回 `true`，否则返回 `false`。	`date1, date2, [unit]`	Boolean	`IS_AFTER("2023-09-10", "2023-09-08") => true` `IS_AFTER("2023-09-10", "2023-09-08", "month") => false`

数组和其他函数

数组和其他函数用于处理汇总数组、去重、合并、清理空值，以及获取记录 ID。

函数名称	描述	输入	输出	示例
COUNTALL	返回所有元素的数量，包括文本和空白。	`value1, [value2, ...]`	Number	`COUNTALL(100, 200, "", "Teable", TRUE()) => 5`
COUNTA	返回非空值的数量。此函数既计算数字又计算文本值。	`value1, [value2, ...]`	Number	`COUNTA(100, 200, 300, "", "Teable", TRUE) => 4`
COUNT	返回数字项的数量。	`value1, [value2, ...]`	Number	`COUNT(100, 200, 300, "", "Teable", TRUE) => 3`
ARRAY_JOIN	使用分隔符将汇总项数组连接成一个字符串。	`array, [separator]`	String	`ARRAY_JOIN(["Tom", "Jerry", "Mike"], "; ") => "Tom; Jerry; Mike"`
ARRAY_UNIQUE	返回数组中仅有的唯一项。	`array`	Array	`ARRAY_UNIQUE([1, 2, 3, 2, 1]) => [1, 2, 3]`
ARRAY_FLATTEN	展平嵌套数组，让所有项目成为单个数组的元素。	`array`	Array	`ARRAY_FLATTEN([1, 2, " ", 3, true], ["ABC"]) => [1, 2, 3, " ", true, "ABC"]`
ARRAY_COMPACT	从数组中删除空字符串和 `null` 值。保留 `false` 和包含空白字符的字符串。	`array`	Array	`ARRAY_COMPACT([1, 2, 3, "", null, "ABC"]) => [1, 2, 3, "ABC"]`
RECORD_ID	返回当前记录的 ID。	`-`	String	`RECORD_ID() => "recxxxxxx"`

最后修改于 2026年5月26日

公式语法关联