公式使用指南|飞书低代码平台

公式使用指南|飞书低代码平台

飞书低代码平台手册精选NaN-NaN-NaN
产品功能
概述
飞书低代码平台提供公式能力,在新增记录或填写表单时,可以实现自动计算字段值,无需人工计算和手动填写。灵活应用公式,可以保证数据准确性,提升效率,例如:
  • 填写完出生日期后,自动计算年龄
  • 编辑完成单价和数量后,自动计算总价,避免手工计算出错
公式用途
飞书低代码平台在公式字段、表单默认值、筛选组件中均提供公式,下面详细介绍在公式字段和表单默认值公式的功能用途。
公式字段
对象中,往往存在一些直接通过规则,就可以明确字段值的字段,如在员工对象中,年龄是可以直接通过出生日期计算,司龄是可以直接通过入职日期计算。
对于此类情况,可以直接使用公式字段进行支持,系统会根据定义的公式,自动计算字段值。
以司龄举例,在员工对象拖入「公式」字段,并完成公式编辑,只要「入职日期」字段有值,系统即会自动计算出「司龄」字段的值。
表单默认值
填写表单时,我们经常会遇到下述场景:确认入职时,希望填入入职日期和试用期月数后,可以自动计算出转正日期,还可以手动更改转正日期的值。
对于此类场景,我们可以给需填写的表单,用公式方式设置表单默认值,以此实现填写表单时,自动计算默认值,且可手动更改默认值。目前,使用公式设置默认值功能在 10 种字段类型中开放:文本、多语文本、数字、日期、日期时间、关联查找、选项、布尔、邮箱、电话号码
以转正日期举例,给「确认入职登记表」中的「预计转正日期」字段设置默认值,使用公式设置并完成编辑,即可实现根据填入的「入职日期」和「试用期(月数)」自动计算。
筛选组件公式
在设置筛选组件时,经常会遇到组件提供的能力无法满足需求的情况,比如:希望每天都能筛选出「截止日期」是在今天之后三天的数据。
筛选组件本身没有提供 TODAY+3 的备选项, 但是,可以在筛选组件的右值输入公式,通过公式的方式支持此类场景。
以 TODAY+3 举例,在筛选组件的右值类型选择「公式」,并在公式编辑器中完成公式编辑,即可实现每次筛选都是筛出 当天+3 的数据。
注:筛选公式中还提供 FILTER 函数,可实现查找跨对象的数据,如查找张三负责的部门:FILTER(部门,部门负责人.EQUALS(张三))
常见用法示例
目的
公式表达式
使用说明
展示文本
"你好呀"
需要使用英文状态的双引号,将需输出的文本引起来
展示数字
12345678
数字可以直接输入
使用字段的值,如部门
部门
直接输入字段名称进行搜索,或在右侧面板中点击插入
将字段和文本等信息进行拼接展示
"基本信息:" + 姓名 + "-" + "部门"
通过「+」连接需要拼接的信息
今天
TODAY()
直接使用 TODAY() 函数,输出今天的日期
明天
TODAY()+1
可以直接将日期与数字进行加减
计算开始日期和结束日期相差的天数
开始日期 - 结束日期
直接使用「-」,计算两个日期 / 日期时间相差天数
计算开始时间和结束时间相差的分钟数
(结束时间-开始时间)*1440
时间相减实际是时间戳相减,会得到单位为天的数字,此数字最多保留 8 位小数。
若单位需要转换为「小时」可再乘 *24;若单位需要转换为「分钟」可再乘 *1440
年龄
(TODAY()-出生日期)/365
将得到的天数差除以一年 365 天。注意,由于除法运算优先级高于减法,所以需要使用 () 来调整优先级
展示用户所在部门的联系方式
部门.邮箱
使用「.」,调用查找字段的对象数据
获取用户的出生年份
出生日期.YEAR()
使用「.」,调用可使用的函数
判断用户的成绩是否优秀
IF(成绩>90,"优秀","继续努力")
使用 IF 函数进行逻辑判断,IF 函数公式结构为:
IF (判断条件, 真值, 假值)
如果判断条件为真,则返回真值,如果判断条件为假,则返回假值。更多信息,详见:IF 函数
公式结构
公式通常由函数字段运算符常量组成。可根据实际需求,使用部分或全部四种元素编辑公式。
250px|700px|reset
image.png
元素名称
描述
函数
函数是系统为实现特定功能,预先定义好的规则。根据函数的规则要求,输入需要的入参,函数即会自动计算出特定结果。
使用时,可点击右侧面板中函数进行插入,或在编辑器中手动输入函数名称搜索选择,例如:
  • TODAY() 函数,不需要入参,使用时直接输入 TODAY() 即会返回当前日期
  • DATE(year, month, day) 函数,输入 year、month、day 三个参数后,即会返回由 year、month、day 组成的日期,如 DATE(2021,1,1) = 2021-01-01
目前飞书低代码平台已支持的函数及其使用规则可见:公式支持的函数
字段
公式中可直接引用字段,使用字段来进行计算。
使用时,可点击右侧面板中字段进行插入,或在编辑器中手动输入字段名称搜索选择。特别的是,若需使用关联对象的字段,可通过「.」运算符进行调用,如「部门.部门负责人」
字段的使用方式与其字段类型相关,具体使用规则可见:公式支持的字段类型
运算符
运算符指要执行的计算类型或其执行顺序。
常见运算符包括计算运算符 +、-、*、/,比较运算符 >、<、=、>= 、<=,逻辑运算符 &&、|| 等
目前飞书低代码平台已支持的运算符及其使用规则可见:公式支持的运算符
常量
常量指的是手动输入的文本字符串或数字。
输入文本字符串时,需要使用英文双引号将需输入的文本括起来,如 "你好呀";输入数字时,可直接进行输入。
公式规则
飞书低代码平台中公式的使用规则与 Excel 公式基本一致,但是,为使公式使用时更加简化、清晰和高效,我们在功能方面做了部分调整,请注意以下三点:
  1. 支持链式调用
对于 Excel 中复杂的公式,需要将函数层层嵌套,导致公式会比较难理解。为避免这类问题,飞书低代码平台支持使用链式调用的方式来提升可读性。
链式调用,是使用点运算符「.」来将公式中的步骤分开,以此调用函数。
示例:使用公式判断今天是否为周一
  • Excel 调用:CONTAINS(DAYNAME(TODAY()),"周一")
  • 链式调用:TODAY().DAYNAME().CONTAINS("周一")
  1. 使用字段名称,而不是使用坐标
Excel 中若需使用数据,需要输入坐标(如 A2:A33、B2&),数字具体指代哪一部分会较难理解。在飞书低代码平台中,可直接输入字段名称搜索或点击插入对应字段,使用字段名称来参与编辑公式。
示例:计算转正日期
  • ADDMONTHS(入职日期,试用期月份)
  1. 支持格式美化
复杂公式在一键格式美化后,可以按照代码格式化逻辑自动展示缩进,以方便用户理解查看。
注意事项
  • 使用函数等资源时,请详细阅读说明,注意参数的类型。公式可使用的函数可见:公式支持的函数
  • 可输入函数或字段名称进行搜索,或在右侧面板中单击选择
  • 可在函数或字段后输入「.」符号,快速调用其他函数或字段
  • 请使用英文输入法输入运算符等符号(如 + - * \ "" () )
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
公式使用指南|飞书低代码平台
先进生产力和业务协同平台
联系我们立即试用
联系我们立即试用