让日期真正变成可用的业务维度：SAP UI5 SmartFilterBar 的 Date Filter Fields 全面解析

在企业应用里，日期从来不只是一个孤零零的字段。订单的 创建日期、发票的 过账日期、项目的 计划起止日期、凭证的 有效期，背后都对应着不同的筛选语义与交互期待。SmartFilterBar 作为一个基于元数据驱动的控制，恰恰把这件事做到了高度可配置与一致体验：开发者只需在 OData 元数据与注解中把规则讲清楚，界面就能自动渲染出恰当的日期筛选器，包括单值、区间、多值，以及带语义的动态日期。本文围绕 More About Controls 的 Date Filter Fields，系统阐释底层机制、配置要点、渲染映射、Fiori elements 的集成方法，以及与 ValueList 注解 InOut 参数的协同与边界，配上真实业务场景与实践建议，帮助你把日期筛选做对、做好。

---

一、元数据是开端：如何让一个属性被识别为日期筛选字段

SmartFilterBar 的生成逻辑源自服务的元数据。想让某个属性作为日期筛选字段，需要满足两件事：其一，属性类型是 Edm.DateTime 或 Edm.DateTimeOffset，其二，为纯日期呈现时应带上 sap:display-format=Date，以指示忽略时间部分并按日期交互。对应 OData V2 的模型里，`sap:display-format=`Date 是