应用程序编辑器中的完整表达式列表

本文包含可在应用程序编辑器的触发器函数中使用的表达式的完整列表。

使用表达式可以以不同方式利用数据，或将数据处理成不同形式。

:::(Info) (注）App 编辑器中的表达式列表与分析编辑器中的表达式不同：

应用程序编辑器中的可用表达式

所有示例都基于应用程序完成度。因此，例如，当您使用 MAXIMUM() 或 MINIMUM() 函数时，您要查找的是应用程序所有完成过程中变量的最大值或最小值。

**ADD_TIME()**按指定的数量和时间间隔单位递增日期时间值。

例如ADD_TIME*(datetime_variable,*2, 'years')

**SUBTRACT_TIME()**按指定的数量和时间间隔单位减少日期时间值。

例如SUBTRACT_TIME*(datetime_variable,*3, 'months')

类型转换表达式

datetimetotext()

将日期时间值转换为便于人类阅读的文本值

示例DATETIMETOTEXT*(datetime_variable*, "MMMM DD, YYYY", 'America/New_York')

这将把日期时间转换为东部标准时间，并以传统的日期格式显示，如 "2019 年 1 月 1 日"。

**注意：**最后一个参数（时区）必须来自此处列出的某个tz 数据库名称。

FILETOTEXT("url: File") => 文本 将文件转换为 URL 文本字符串

例如：FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

HEX_TO_INT()

返回给定十六进制字符串的数字表示形式。

例如HEX_TO_INT('0xAB18') = '43800

INT_TO_HEX()

返回给定数字的十六进制表示形式。

例如INT_TO_HEX('43800') = '0xAB18

INTERVAL_TO_SECONDS(interval: Interval) => Number 返回以秒为单位的区间长度。

EX.INTERVAL_TO_SECONDS(seconds_too_interval(30.0))

LOWERCASE()

将字符串转换为全小写

MAP_TO_BOOLEAN_LIST*(a:*{} array,b: text) => array 将对象数组转换为给定键的基数组

Ex.MAP_TO_BOOLEAN_LIST([{key: value}], 'key') = [value］

MAP_TO_INTEGER_LIST*(a:*{} 数组,b: 文本) => 将对象数组转换为给定键的基数组

Ex.MAP_TO_INTEGER_LIST([{key: value}], 'key') = [value] 返回值

MAP_TO_NUMBER_LIST*(a:*{} array,b*:*text) => array 将对象数组转换为给定键的基数组。

Ex.MAP_TO_NUMBER_LIST([{key: value}], 'key') = [value] ([key:value])。

MAP_TO_TEXT_LIST*(a:*{} array,b*:*text) => array 将对象数组转换为给定键的基数组。

Ex.MAP_TO_TEXT_LIST([{key: value}], 'key') = [value] ([key:value]])。

**SECONDS_TO_INTERVAL()**将秒转换为区间。

SECONDS_TO_INTERVAL(seconds: Integer or Number) => Interval

Ex.seconds_too_interval(20) => 0:00:20

**TEXTTOBOOLEAN()**将文本解析为布尔值。

y"、"yes"、"t"、"true "和 "on "以及任何大写的变体都被识别为 true，而 "n"、"no"、"f"、"false "和 "off "被识别为 false。

示例TEXTTOBOOLEAN("yes")

texttodatetime()

使用指定参数将文本值转换为日期时间值。常用于共享文本格式 Datetime 值的 Connector 函数需要转换时。

TEXTTOIMAGEURL(url:Text)=> 图像 URL 将字符串转换为图像 URL。

例如texttoimageurl("https://example.com/photo.jpg")

**TEXTTOINTEGER()**将文本或时间间隔解析为整数。

例如texttointeger("123")

**TEXTTONUMBER()**将文本或时间戳解析为数字

例如texttonumber("2.4")

**TOTEXT()**将任何内容解析为文本。

例如TOTEXT(2)

UPPERCASE()

将字符串转换为全大写字符串

USER_ID_TO_USER(id: Text) => User 将用户 ID 转换为用户对象

例如User_id_too_user("abc") = User

截断表达式

CEIL()

向上舍入到最接近的整数

FLOOR()

向下舍入到最接近的整数

ROUND()

将一个数字舍入到指定的小数位数。最多 3 位小数。

例如1 - round(123.123456, 1)

返回 123.1

例 2 - ROUND(123.12)

将返回 123

rounddatetime()

将日期时间值截断为指定单位，如月或日。

示例ROUNDDATETIME*(datetime_variable*, "Month", "America/New_York")

这会将日期时间转换为东部标准时间中的月份。

**注意：**最后一个参数（时区）必须来自此处列出的某个tz 数据库名称。

数值返回表达式

ABS()

返回数字的绝对值

CONTAINS()

返回字符串是否包含给定子串

例如contains("123abc", "123")

将返回 "true

COS()

返回给定输入值的余弦值

ENCODE_URI(component: Text) => 文本

返回 URI 的 URL 编码字符串版本。

例如ENCODE_URI("http://example.com/a=foo&b=atest") ="http://example.com/a=foo&b=a%20test"

ENCODE_URI_COMPONENT(component: Text) => 文本

返回 URI 组件的 URL 编码字符串版本。

例如ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"

**FIND()**返回第一个参数在第二个参数中出现的位置。

IF()

根据第一个参数，如果第一个参数为真，则返回第二个参数；如果第一个参数为假，则返回第三个参数。

例如IF(true, 1, 2)

**ISNULL()**如果参数为空，则返回 true，否则返回 false。

**LEFT()**返回文本值的子串，从第二个参数指定的位置开始。

**LEN()**返回文本值的长度。

LINK()

返回第一个非空参数。

例如LINK(weight, 70)

如果weight的值为

MAX()

返回值最大的参数

例如MAX(var1, var2)

如果 var1 的值大于 var2 的值，则返回 var1 的值

**MID()**从第二个参数指定的位置开始，返回文本值的子串。第三个参数指定返回值的长度。

**MIN()**返回值最小的参数

例如MIN(var1, var2)

如果 var1 的值小于 var2 的值，则返回该值

POW()

返回第一个参数升高到第二个参数的值

Ex.POW(3,2)

将返回 9

RAND()

随机产生一个介于 0 和 1 之间的十进制数

RANDBETWEEN()

生成介于两个指定数字之间的随机整数

例如RANDBETWEEN(5,10)

RANDOMSTRING()

返回一个 17 个字符的随机字符串。用于为新表记录创建 ID。

**RANDOM_COLOR()**生成随机颜色

例如RANDOM_COLOR() = ##c537a5

RGA(r: Integer, g:Integer, b:Integer, a:Integer) => 颜色 返回指定的红、绿、蓝和字母成分的颜色

Ex.RGA(255, 255, 0, 0.5) = ##ffff00 （不透明度 50）

RGB(r: Integer, g:Integer, b:Integer) => 颜色 返回指定的红色、绿色和蓝色分量的颜色

例如RGB(255, 255, 0) = ##ffff00

**RIGHT()**返回文本值的子串，以第二个参数指定的位置结束。

SIN()

返回给定输入值的正弦值

SPLIT() 用指定的分隔符将文本值分割成数组。

SQRT()

返回一个数字的平方根

SUBSTITUTE()

在第一个参数给定的字符串中，用第三个参数替换第二个参数的所有示例

例如replace("A734", "7", "3")

将返回 "A334

TAN()

返回给定输入值的正切值

**TRIM()**删除第一个参数前后的子串（由第二个参数指定）。

数组表达式

ARRAY_AVG()

返回数组中所有数字的平均值

例如array_avg([1,2,3])

将返回 2

ARRAY_CONCAT()

返回参数中包含数组中所有元素的单个数组。仅适用于相同类型的数组，即所有文本数组。

例如ARRAY_CONCAT([1,2],[3,4],[5,6])

将返回 [1,2,3,4,5,6].

arraycontains()

确定一个值是否在数组中

示例arraycontains([1,2,3], 1)

将返回 "true

ARRAY_MAX()

从给定数组中返回最小值

例如array_max([1,2,3])

将返回 3

ARRAY_MIN()

从给定数组中返回最小值

例如array_min([1,2,3])

将返回 1

array_stdev_population()

返回给定数值数组的总体标准偏差

Ex.array_stdev_population([1,2,3])

将返回 0.816496580927726

array_stdev_sample()

返回给定数值数组样本的标准差

Ex.array_stdev_sample([1,2,3])

将返回 1

**REGEX_MATCH()**返回文本值的正则表达式匹配数组。根据给定的正则表达式和修饰符进行匹配。该方法基于match JavaScript 方法，有 2 种 "模式"。

如果给定 2 个参数，该方法相当于以下 JavaScript 表达式：text.match(new RegExp(regex))如果提供可选参数 modifiers，该方法相当于以下 JavaScript 表达式：text.match(new RegExp(regex, modifiers))Modifiers 是可以用来修改 regex 搜索行为的标志。

**REGEX_REPLACE()**返回文本值的正则表达式匹配数组。根据给定的正则表达式和修饰符进行匹配。此方法基于replace JavaScript 方法。

当函数给定 3 个参数时，它等价于以下 JavaScript 表达式：text.replace(new RegExp(regex), replacement)。 当提供可选参数 modifiers 时，此方法等价于以下 JavaScript 表达式：text.replace(new RegExp(regex, modifiers), replacement)Modifiers 是可用于修改 regex 搜索行为的标志。

找到您想要的东西了吗？

你也可以前往community.tulip.co发布你的问题，或看看其他人是否也遇到过类似问题！