过滤查询语法

表达式结构

查询结构是由field、operator和value组成:

假设有一个表达式name==text，结构解释如下

名称	描述
`name`	字段ID或字段名称, 带有空格的名称, 可以使用大括号包裹, 比如`{single text}`
`==`	比较运算符, 字段类型不同, 支持的运算符也有所不同, 往下有详细说明
`text`	带有空格的值, 通常使用双引号包裹, 比如`name=="text 1"`

注意: field只能使用系统预留字符之外的字符, 不能使用空格, 如果需要使用空格, 可以使用大括号包裹, 比如{single text}

系统预留字符

" ' ( ) ; , = ! ~ < > \n \t \r

操作符

逻辑运算符

逻辑运算符	描述
`;` or `and`	AND 与
`,` or `or`	OR 或

组合查询, 将多个表达式组合在一起, 形成一个复杂的查询条件

注意: 两种逻辑运算符在一次查询里只能使用一种, 不能混用,and和or不能同时存在, 比如 ✅合法: single_text=="text 1";single_text=="text 2";single_text=="text 3" ❌不合法: single_text=="text 1";single_text=="text 2",single_text=="text 3"

比较运算符

比较运算符	描述
`==`	等于
`!=`	不等于
`>`	大于
`<`	小于
`>=`	大于等于
`<=`	小于等于
`=c=`	包含
`=nc=`	不包含

比较值

通常可以是字符串/数字, 参考下面示例

示例	类型	描述
`text`	string	文本
`"simple text"`	string	带有空格的文本, 必须使用双引号包裹
`123`	number	数字
`"123.45"`	number	浮点数, 必须使用双引号包裹, 对于数字类型可精度匹配
`true`,`1`	boolean	针对复选框字段类型的单元格值, 这两个可以为true
`false`,`0`	boolean	针对复选框字段类型的单元格值, 这两个可以为false
`null`, `NULL`	null	判断是否单元格值为空, 使用`==`,`!=`搭配判断
`("option 1", "option 2")`	array	数组, 单元格表现为数组时可使用, 搭配`=c=`,`=nc=`, `==`, `!=`使用

查询示例

单行文本查询

支持操作符: ==, !=, =c=, =nc=

运算符	字段名称	查询示例	描述
等于	`single_text`	`single_text=="simple text"`	精确匹配指定内容的的单元格
不等于	`single_text`	`single_text!="simple text"`	精确不匹配指定内容的的单元格
包含	`single_text`	`single_text=c="simple text"`	包含指定内容的的单元格, 值只能是`string`
不包含	`single_text`	`single_text=nc="simple text"`	不包含指定内容的的单元格, 值只能是`string`
为空	`single_text`	`single_text==null`或`single_text==NULL`	单元格内容为空
非空	`single_text`	`single_text!=null`或`single_text!=NULL`	单元格内容不为空

数字查询

支持运算符: ==, !=, >, <, >=, <=

运算符	字段名称	查询示例	描述
等于	`number_field`	`number_field==123`	精确匹配指定数字的单元格
不等于	`number_field`	`number_field!=123`	精确不匹配指定数字的单元格
大于	`number_field`	`number_field>123`	数字大于指定值的单元格
小于	`number_field`	`number_field<123`	数字小于指定值的单元格
大于等于	`number_field`	`number_field>=123`	数字大于等于指定值的单元格
小于等于	`number_field`	`number_field<=123`	数字小于等于指定值的单元格
为空	`number_field`	`number_field==null`或 `number_field==NULL`	单元格内容为空
非空	`number_field`	`number_field!=null`或`number_field!=NULL`	单元格内容不为空

复选框查询

支持运算符: == 支持值: true, false, 1, 0

运算符	字段名称	查询示例	描述
等于	`checkbox`	`checkbox==true`或`checkbox==1`	查询已勾选的单元格所在行
等于	`checkbox`	`checkbox==false`或`checkbox==0`	查询未勾选的单元格所在行

单选查询

支持运算符: ==, !=, =c=, =nc=

运算符	字段名称	查询示例	描述
等于	`single_select`	`single_select=="Option 1"`	精确匹配指定选项的单元格
不等于	`single_select`	`single_select!="Option 1"`	精确不匹配指定选项的单元格
包含	`single_select`	`single_select=c=("Option 1", "Option 2")`	包含指定选项的单元格
不包含	`single_select`	`single_select=nc=("Option 1", "Option 2")`	不包含指定选项的单元格
为空	`single_select`	`single_select==null`或`single_select==NULL`	单元格内容为空
非空	`single_select`	`single_select!=null`或`single_select!=NULL`	单元格内容不为空

多选查询

支持运算符: ==, !=, =c=, =nc=

值类型: 数组, 比如("Option 1", "Option 2")

运算符	字段名称	查询示例	描述
等于	`multi_select`	`multi_select==("Option 1", "Option 2")`	精确匹配指定选项的单元格
不等于	`multi_select`	`multi_select!=("Option 1", "Option 2")`	精确不匹配指定选项的单元格
包含	`multi_select`	`multi_select=c=("Option 1", "Option 2")`	包含指定选项的单元格
不包含	`multi_select`	`multi_select=nc=("Option 1", "Option 2")`	不包含指定选项的单元格
为空	`multi_select`	`multi_select==null`或`multi_select==NULL`	单元格内容为空
非空	`multi_select`	`multi_select!=null`或`multi_select!=NULL`	单元格内容不为空

日期查询

支持运算符: ==, !=, >, <, >=, <=

日期比较值只能精确到年月日, 不可精确到时分秒, 比如

✅合法: 2023-10-01 ❌不合法: ```2023-10-01 12:00:00`

运算符	字段名称	查询示例	描述
等于	`date`	`date=="2023-10-01"`	匹配在指定时间内的单元格值
不等于	`date`	`date!="2023-10-01"`	不匹配在指定时间内的单元格值
大于	`date`	`date>"2023-10-01"`	日期大于指定值的单元格
小于	`date`	`date<"2023-10-01"`	日期小于指定值的单元格
大于等于	`date`	`date>="2023-10-01"`	日期大于等于指定值的单元格
小于等于	`date`	`date<="2023-10-01"`	日期小于等于指定值的单元格
为空	`date`	`date==null`或`date==NULL`	单元格内容为空
非空	`date`	`date!=null`或`date!=NULL`	单元格内容不为空

关联查询

支持运算符: ==, !=, =c=, =nc=

值类型: 数组, 比如("record1", "record2")

运算符	字段名称	查询示例	描述
等于	`link`	`link==("record1", "record2")`	精确匹配指定记录的单元格
不等于	`link`	`link!=("record1", "record2")`	精确不匹配指定记录的单元格
包含	`link`	`link=c=("record1", "record2")`	包含指定记录的单元格
不包含	`link`	`link=nc=("record1", "record2")`	不包含指定记录的单元格
为空	`link`	`link==null`或`link==NULL`	单元格内容为空
非空	`link`	`link!=null`或`link!=NULL`	单元格内容不为空

模板

帮助

价格

博客

社区

过滤查询语法

表达式结构

操作符

逻辑运算符

比较运算符

比较值

查询示例

单行文本查询

数字查询

复选框查询

单选查询

多选查询

日期查询

关联查询

推荐阅读

推荐AI自动化模板