函数列表

宜搭Pro平台目前支持50个函数,本文简单介绍宜搭Pro支持的函数。

背景信息

在您搭建应用的时候,可能需要使用“插入函数”功能来辅助值的设置和计算,比如在新建计算公式字段设置计算公式的值,为文本类型字段设置大写转小写、以及在新建校验规则中设置校验条件等。

函数列表

函数类别 函数名称 函数书写 实例 说明
日期和时间类函数 当前时间函数 NOW NOW() 返回数据填写时的日期+时间。
日期和时间类函数 当前日期函数 TODAY TODAY() 返回数据填写时的日期。
日期和时间类函数 时间小时数函数 HOUR HOUR(datetime) 如果当前时间为2019-07-09 14:34:45,则返回14。返回的是小时数,在0-23之间。
日期和时间类函数 日期之间的天数函数 DAYS DAYS(end_date,start_date) 返回两个日期间的天数差值,日期和日期时间字段可以参与计算(时分秒不参与计算)。
日期和时间类函数 时间之间的小时数函数 HOURS HOURS(end_time,start_time) 返回两个时间之间的小时差值,例如,计算耗时。
日期和时间类函数 时间分钟数函数 MINUTE MINUTE(datetime) 如果当前时间为2019-07-09 14:34:45,则返回34,返回的是分钟数,在0~59之间。
日期和时间类函数 时间之间的分钟数函数 MINUTES MINUTES(end_time,start_time) 返回两个时间之间的分钟差值,例如,计算耗时。
日期和时间类函数 时间秒数函数 SECOND SECOND(datetime) 如果当前时间为2019-07-09 14:34:45,则返回45,返回的是秒数,在0~59之间。
日期和时间类函数 日期天数函数 DAY DAY(date) 如果当天是2019-07-09,则返回为9,将日期转化返回为整数,在1~31之间。
日期和时间类函数 日期所属季度函数 QUARTER QUARTER(date) 返回填写日期所属的季度,返回是1~4之间的整数。
日期和时间类函数 数字转日期函数 DATE DATE(year,month,day) 根据输入的年月日的值,返回日期类型的数据。
其中年月日均为必填:
  • 年份只接受1970-9999之间的整数。
  • 月只接受1-12之间的整数。
  • 日只接受1-31之间的整数。
  • 错误日期,例如1998,2,31, 返回null。
日期和时间类函数 数字转日期时间函数 DATETIME DATE(year,month,day,hour,minute,second) 根据输入的年月日的值,返回日期类型的数据。
其中年月日和时间均为必填:
  • 年份只接受1970-9999之间的整数。
  • 月只接受1-12之间的整数。
  • 日只接受1-31之前的整数。
  • 小时只接受0-23之间的整数。
  • 分钟只接受0-59之间的整数。
  • 秒只接受0-59之间的整数。
  • 错误日期,例如1998,2,31, 返回null。
日期和时间类函数 文本转日期函数 DATEVALUE DATEVALUE(expression) 根据输入的年月日值,返回一个日期类型的数据。参数需为文本类型,输出为日期类型。
日期和时间类函数 文本转日期时间函数 DATETIMEVALUE DATETIMEVALUE(expression) 根据输入的年月日和时间值,返回一个日期时间类型数据。参数需为文本类型,输出为日期时间类型。
日期和时间类函数 星期函数 WEEKDAY WEEKDAY(date) 返回指定日期、日期时间字段或者数据的星期几,返回值是1~7之间的整数。1代表周一,以此类推。
日期和时间类函数 日期的年份函数 YEAR YEAR(TODAY()) 如果当天是2019-07-09,则返回2019。将日期转化返回为整数,在1970~9999之间。
日期和时间类函数 日期之间的年数函数 YEARS YEARS(end_date,start_date) 返回两个日期之间的年数差值。例如 ,计算年龄时,只对年份数据进行计算,默认四舍五入后输入整数(时分秒不参与计算)。
日期和时间类函数 日期的月份函数 MONTH MONTH(TODAY()) 如果当天是2019-07-09,则返回为7。将日期转化返回为整数,在1~12之间。
日期和时间类函数 日期加天数函数 ADDDAY ADDDAY(date,number) 返回日期加、减天数后的日期值,天数必须为整数(负整数视为减去天数)。
日期和时间类函数 时间加小时函数 ADDHOUR ADDHOUR(datetime,number) 返回日期时间加、减小时后的日期时间值,number必须为整数(负整数视为减去小时)。
日期和时间类函数 周数函数 WEEKNUM WEEKNUM(date,return_type) 返回特定日期在一年中的“第几周”。return_type默认1是周一开始,2是周二开始(以此类推)。返回的是整数。
逻辑型函数 判断为空函数 ISEMPTY ISEMPTY(fieldName) 判断值是否为空字符串、空对象或者空数组。是空的返回true,否则返回false。
逻辑型函数 是否数字函数 ISNUMBER ISNUMBER(fieldName) 判断文本值是否为数字,如果是数字返回true,否则返回false。ISNUMBER(Order.account_number)。
逻辑型函数 如果函数 IF IF(logical_test,value_if_true,value_if_false) 返回值无固定类型,根据value_if_true或者value_if_false类型来界定,logical_test为判断依据。value可以是值、字段或表达式,但必须同类型。
逻辑型函数 选项值是否包含特定值函数 INCLUDES INCLUDES(multiselect_picklist_field,text_literal) 判断多选字段选项列表中当前选择的值中是否有值等于指定的文本,如果有,则返回true,否则返回false。text_literal可以是文本字段、加双引号文本字符串或者返回值为文本的表达式。
数值型函数 求和函数 SUM SUM(muber1,number2) 返回入参的求和值,可使用整数、浮点、货币等字段以及数值。
数值型函数 求绝对值函数 ABS ABS(number) 返回入参的绝对值,可使用整数、浮点、百分比等数值字段、常量或表达式参与计算。
数值型函数 平均值函数 AVERAGE AVERAGE(number1,number2,…) 返回参数的平均值(算术平均值),可使用整数、浮点、货币等字段以及数值。
数值型函数 最大值函数 MAX MAX(number1,number2,…) 返回一组数值中的最大值。
数值型函数 向上舍入函数 CEILING CEILING(number) 将参数number向上舍入,number可以是数值或货币。
数值型函数 向下舍入函数 FLOOR FLOOR(number) 将参数number向下舍入,number可以是数值或货币。
数值型函数 对数函数 LOG LOG(number,[base]) number为数值型,返回以base为底数的对数(不填默认为10,base必须为正整数)。
数值型函数 幂运算函数 POWER POWER(number,power) number为数值型,power为基数乘幂运算的指数(power必填)。
数值型函数 格式化为人民币格式函数 RMBFORMAT RMBFORMAT(number,type) number为货币结果的数值、字段及表达式;
type为类型(0/1)0表示元整,1表示角整,不填默认元整。
数值型函数 平方根函数 SQRT SQRT(number) 返回正的平方根,number不能为负数。
数值型函数 最小值函数 MIN MIN(number1,number2) 返回一组值中的最小值。
文本型函数 包含判断函数 CONTAINS CONTAINS(text1,text2) 判断字符串(text1)是否包含字符串(text2)的值,包含则返回true,不包含则返回false。
文本型函数 查找文本位置函数 FIND FIND(findtext,withintext,[start_num]) 在第二个文本字符串中查找第一个文本字符串,并返回第一个文本字符串的起始位置的编号,该编号从第二个文本字符串的第一个字符算起。返回0则表示未查找到。
文本型函数 日期或日期时间转文本函数 FORMATDATE FORMATDATE(DATE,pattern) 将日期格式转化为指定格式文本格式;例如,TEXT([日期],”yyyy-mm-dd HH:MM:SS”)。
文本型函数 数字格式转文本函数 FORMATNUM FORMATNUM(num1,pattern) 将数字格式转化为指定格式文本;TEXT([数字字段],”#.##”)。
文本型函数 文本格式转数字函数 VALUE VALUE(text) 将标识数值的文本字符串转化成数值,返回值为整数、浮点、百分比类型。Text参数内容应保证为数字,如包含除小数点、百分号之外的其他非法字符或符号,整体返回null。
文本型函数 最左侧字符函数 LEFT LEFT(text,[num_chars]) 将一个字符串取最左的几位数,num_chars可选,不填写默认是1。例如LEFT(“阿里巴巴”,2),返回的是阿里。
文本型函数 文本字符个数函数 LEN LEN(text) 返回文本字符串中的字符个数。
文本型函数 大写转小写函数 LOWER LOWER(text) 将一个文本字符串中的所有大写字母转换为小写字母。
文本型函数 返回特定字符函数 MID MID(text,start_num,num_chars) 返回文本字符串中从指定位置开始的特定数目的字符,text为文本字符串,start_num为指定开始位置,为必填且为大于0的整数,num_chars为必填,也必须是大于0的整数。例如MID(“阿里巴巴”,3,2),返回是巴巴。
文本型函数 替换字符函数 REPLACE REPLACE(oldtext,start_num,num_chars,newtext) 例如,从第一个字符替换4个字符为aaaa-REPLACE([ABCDEF],1,4,aaaa)返回aaaaEF。
文本型函数 最右侧字符函数 RIGHT RIGHT(text,[num_chars]) 将一个字符串取最右的几位数,num_chars可选,不填写默认是1。例如RIGHT(“阿里巴巴”,2),返回的是巴巴。
文本型函数 开头判断函数 STARTSWITH STARTSWITH(text,startString) 判断字符串(text)是否以特定字符串(startString)开始,是则返回true,否则返回false。
文本型函数 去除文本两边空格函数 TRIM TRIM(text) 删除字符串首尾的空格,但是会保留字符串内部作为词与词之间分隔的空格。
文本型函数 小写转大写函数 UPPER UPPER(text) 将一个文本字符串中的所有小写字母转换为大写字母。