服务端 API/历史版本（不推荐）/云文档/多维表格/记录筛选的指南
# 记录筛选的开发指南
**注意事项**：该文档为历史版本。要查看对应最新版本文档，参考[记录过滤参数填写指南](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide)。

在[列出记录](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/list)中可以通过查询参数 filter 去筛选出你需要的 records。

## 注意事项

filter 后的表达式支持[公式语法](https://www.feishu.cn/hc/zh-CN/articles/360049067853)，可通过 AND 或 OR 来组合。

表达式的语法为: ==CurrentValue.[字段名]==，其中首字母 C 和 V 要大写。

由于 URL 支持字符集的限制，需要将请求参数编码之后传输，如“+”号要编码为“%2B”。

## 常用筛选公式
逻辑名称 | 表达式
| --------- | --------------- |
| 为空 | `CurrentValue.[订单号] =""` |
| 不为空 | `NOT(CurrentValue.[订单号] ="")` |
| 等于 | `CurrentValue.[订单号] = "003"` |
| 不等于 | `CurrentValue.[订单号] != "003"` |
| 大于等于| ` CurrentValue.[价格] >= 10.5 ` |
| 小于等于| `CurrentValue.[订单号] <= "003"` |
| 包含 | `CurrentValue.[订单号].contains("003")` |
| 不包含 | `NOT(CurrentValue.[订单号].contains("003"))` |
| AND | `表达式1&&表达式2 或者 AND(表达式1,表达式2)` |
| OR | `OR(表达式1,表达式2)` |

## 常用的逻辑表达式
与
>  AND(CurrentValue.[订单号].contains("004"),CurrentValue.[订单日期]= TODAY())

或
>  OR(CurrentValue.[订单号].contains("004"),CurrentValue.[订单号].contains("009"))

## 常用的日期表达式
今天
> CurrentValue.[订单日期] = TODAY()

昨天
> CurrentValue.[订单日期] = TODAY()-1

明天
> CurrentValue.[订单日期] = TODAY()%2B1

本周
> AND(TODAY()-(WEEKDAY(TODAY(),2)-1)<=CurrentValue.[订单日期], CurrentValue.[订单日期]<=TODAY()%2B(7-WEEKDAY(TODAY(),2))) 

本月
> AND(DATE(YEAR(TODAY()),MONTH(TODAY()),1)<=CurrentValue.[订单日期], CurrentValue.[订单日期]<=DATE(YEAR(TODAY()),MONTH(TODAY())%2B1,0)) 

过去N天
> today()-N%2B1 <= CurrentValue.[订单日期]&&CurrentValue.[订单日期] <= today()

未来N天
> today()<= CurrentValue.[订单日期]&&CurrentValue.[订单日期] <= today()%2BN-1

在某个日期之内
> CurrentValue.[订单日期] > TODATE("2021-06-01")&&CurrentValue.[订单日期] < TODATE("2021-06-31")

## 字段筛选示例
| 字段         |  筛选示例       |
| --------- | --------------- |
|多行文本 | `CurrentValue.[字段名1]="内容a"` |
|单选 | `CurrentValue.[字段名1]="选项内容a"` |
|多选 | `CurrentValue.[字段名1]="选项内容a"` |
|人员 | `CurrentValue.[人员]="袁志伟"` |
|电话号码 | `CurrentValue.[电话号码]="+2020202020"` |
|日期 | `CurrentValue.[订单日期] = TODAY()` |
|附件 | `CurrentValue.[字段名1]="内容a"` |
|数字 | `CurrentValue.[字段名1]=1` |
|复选框 | `CurrentValue.[字段名1]=1` |
|超链接 | `CurrentValue.[超链接]="超链接的文本值"` |
|公式 | `CurrentValue.[字段名1]="内容a"`（如果公式返回值为数字，则不需要双引号，如`CurrentValue.[字段名1]=123`）|
|查找引用 | `CurrentValue.[字段名1]="内容a"` |
|单向关联 | `CurrentValue.[字段名1]="内容a"` |
|创建人 | `CurrentValue.[创建人]="人名a"`|
|创建时间 | `CurrentValue.[字段名1]>TODAY()` |
|修改人 | `CurrentValue.[修改人]="小Lark"` |
|最后更新时间 | `CurrentValue.[字段名1]>TODAY()` |
|自动编号 | `CurrentValue.[自动编号]="001no20220624"` |