文本型函数

本文档主要介绍宜搭Pro平台目前对“ 插入函数” 功能中支持的文本型函数进行详细说明。

包含判断函数(CONTAINS)

内容项 说明
描述 判断字符串(text1)是否包含字符串(text2)的值,包含则返回true,不包含则返回false。
使用方法 CONTAINS(text1,text2),返回一个布尔型值。
样例 IF(CONTAINS(Product_Type,”part”),”Parts”,”Service”)。检查文本字段 Prodcut_Type(产品类型)的输入值是否包含part,如果包含范围Parts,不包含时返回Service。
注意事项
  • 值为空在字段也会参与判断。
  • CONTAINS函数不支持多选字段的判断,多选字段请使用INCLUDES函数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

查找文本位置函数(FIND)

内容项 说明
描述 从withintext中找findtext(从 start_num 为起始开始查找),并返回字符所在位置。
使用方法 FIND(findtext,withintext,[start_num])
样例
  • Find(“@alibaba-inc.com”,”bxx@alibaba-inc.com”,3)此公式返回结果为2。
  • Find(“@alibaba-inc.com”,”bxx@alibaba-inc.com”)此公式返回结果为4。
注意事项
  • start_num为选填,不填写时默认从1开始查找。
  • 此函数固定返回整数(标识从查找位置后第几位有对应文本)。此函数固定返回整数(标识从查找位置后第几位有对应文本)。
  • findtext是整体严格匹配。
  • 如果没有找到,返回0。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期或日期时间转文本函数(FORMATDATE)

内容项 说明
描述 将日期转化为指定的文本格式。
使用方法 FORMATDATE([date],”yyyy-mm-dd HH:MM:SS”)
样例 DATEVALUE(FORMATNUM(YEAR(TODAY()),”####”)&”-06-05”),返回一个以today为年份的6月5号日期。
注意事项
  • 入参date需要是个日期型值
  • 返回的文本值会保留日期格式中“-”连接符。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

数字格式转文本函数(FORMATNUM)

内容项 说明
描述 将数值转化为指定的文本格式。
使用方法 FORMATNUM([数字字段],”#.##”)
样例 FORMATNUM([Student.age],”##”)&”岁”返回的值会是“18岁”这样的一个文本值。
注意事项
  • 入参数字字段需要是一个数值。
  • 百分比会转化为小数,再转成文本。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

文本格式转数字函数(VALUE)

内容项 说明
描述 将表示数值的文本转化为数值格式值。
使用方法 VALUE(text),返回数值。
样例 Value(“12.34567”),此公式返回结果为12.34567。
注意事项 text参数内容应保证为数字,如包含除小数点、百分号之外的其他非法字符或符号,整体返回null。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

最左侧字符函数(LEFT)

内容项 说明
描述 将一个字符串取最左的几位,返回一个文本型值。
使用方法 LEFT(text,[num_chars]),标识从text的最左边开始,取num_chars个字符(中英文都视为1个字符)。
样例 LEFT(“阿里巴巴”,2),此公式返回的是“阿里”。
注意事项
  • num_chars必须是正整数,其他入参返回null。
  • num_chars选填,不填写时,默认为1。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

最右侧字符函数(RIGHT)

内容项 说明
描述 将一个字符串取最右的几位,返回一个文本型值。
使用方法 RIGHT(text,[num_chars]),表示从text的最右边开始,取num_chars个字符(中英文都视为1个字符)。
样例 RIGHT(“阿里巴巴”,2),此公式返回的是“巴巴”。
注意事项
  • num_chars必须是正整数,其他入参返回null。
  • num_chars选填,不填写时,默认为1。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

文本字符个数函数(LEN)

内容项 说明
描述 返回文本字符串的字符数量(一个汉字、一个数字与一个英文字母均视为1个字符)。
使用方法 LEN(text)
样例
  • Len(“阿里巴巴”)此公式返回结果为4。
  • Len(“www.alibaba.com”)此公式返回结果为15。
注意事项
  • 一个汉字、一个数字、一个符号与一个英文字母均视为1个字符。
  • 如果text为空时,函数范围0。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

大写转小写函数(LOWER)

内容项 说明
描述 将一个文本字符串中的所有大写字母转换为小写字母。
使用方法 LOWER(text)
样例 LOWER(“WWW.ALIBABA.COM”),此公式返回结果为“www.alibaba.com”
注意事项 次函数仅对英文大小写生效,中文不报错,返回原值。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

小写转大写函数(UPPER)

内容项 说明
描述 将一个文本字符串中的所有小写字母转换为大写字母。
使用方法 OPPER(text)
样例 UPPER(“www.alibaba.com”),此公式返回结果为“WWW.ALIBABA.COM”。
注意事项 次函数仅对英文大小写生效,中文不报错,返回原值。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

返回特定字符函数(MID)

内容项 说明
描述 返回文本字符串中从指定位置开始的特定数目的字符。
使用方法 MID(text,start_num,num_chars)
样例 MID(“阿里巴巴淘宝”,3,2),返回是“巴巴” 。
注意事项
  • 此函数中,一个英文字母和一个汉字都被认为是一个字符。
  • 当start_num 为0或者负数时返回控制。
  • 当num_chars的值大于text 的长度时,不会报错,将直接截取到字符串最后一个字符。
  • 当要截取字符串的字段为空时,此函数的返回结果在前台也显示为空。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

替换字符函数(REPLACE)

内容项 说明
描述 使用指定文本替换文本字符串中的特定文本。
使用方法 REPLACE(oldtext,start_num,num_chars,newtext)
样例 例如:从第一个字符替换4个字符为aaaa,REPLACE(“ABCDEF”,1,4,aaaa)返回aaaaEF。
注意事项
  • 此函数中的参数值区分大小写字母。
  • 如果new_text 为””,则不做任何处理。
  • 如果在需要替换的字符串中包含多个需要被替换的文本,则会替换多次。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

开头判断函数(STARTSWITH)

内容项 说明
描述 判断文本值是否以特定字符串开始,是则返回True,否则返回False。
使用方法 STARTSWITH(text,startString)
样例 例如STARTSWITH(“阿里巴巴”,”阿里”),此函数表达式返回true。
注意事项
  • 此函数中的参数值区分大小写字母。
  • startString严格匹配。
函数应用位置 字段默认值
  • 公式字段计算
  • 校验规则

去除文本两边空格函数(TRIM)

内容项 说明
描述 删除字符串首尾的空格,但是会保留字符串内部作为词与词之间分隔的空格。
使用方法 TRIM(text)
样例 例如STARTSWITH(“ 阿里 巴巴 “),此函数表达式返回“阿里巴巴”。
注意事项 此函数仅会删除文本入参收尾的空格,但是不会删除文本内部的空格。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则