如何在SharePoint Online REST API中过滤DateOnly列且无需考虑时间部分（适配超5000项列表）

首先先理清你遇到的时间差异根源：SharePoint的DateOnly列本质上还是存储为DateTime类型，只是在UI层面隐藏了时间选择功能。当通过REST API返回数据时，系统会自动将本地时区的日期转换为UTC时间——比如你的站点如果用UTC-5时区，本地日期2021-09-19会转成2021-09-19T05:00:00Z；如果是UTC-6时区，就会变成2021-09-19T06:00:00Z，这就是时间部分不一致的原因。

针对你必须使用/items端点、不能用CAML的需求，有一个规范且高效的解决方案：

使用OData date()函数过滤日期部分 #

SharePoint Online的REST API支持OData 4.0的date()函数，这个函数可以直接提取DateTime字段的纯日期部分，完全忽略时间后缀，刚好匹配你的需求。

示例过滤条件 #

$filter=date(ColName) eq 2021-09-19

对应的完整请求示例：

GET _api/web/lists/getbytitle('你的列表名称')/items?$filter=date(ColName) eq 2021-09-19

这个方法的核心优势：

• 不用再纠结时间部分的偏移差异，直接精准匹配日期
• 相比范围过滤（ge+lt），语法更简洁，且能更好地适配大列表场景（前提是目标列已创建索引）

大列表适配注意事项 #

如果你的列表条目超过5000条，务必给目标DateOnly列创建索引：

1. 进入列表设置 → 列索引
2. 找到你的DateOnly列，添加为索引
   这样date()函数的过滤请求就能利用索引，避免触发SharePoint的列表视图阈值限制，保证请求正常返回。

为什么范围过滤会失效？ #

当列表条目超过5000条时，如果过滤列没有索引，SharePoint无法高效执行范围查询（ge/lt），会直接返回阈值错误。而date()函数结合索引后，查询效率更高，能绕过这个问题。

内容的提问来源于stack exchange，提问作者AymKdn