SharePoint REST API返回中Created与Created.属性的差异咨询

针对RenderListDataAsStream端点返回的带.后缀属性（如Created.、count.），规则如下：

• 不带.后缀的同名字段，是SharePoint存储的原始未加工值：比如Created返回的是数据库层存储的UTC时区ISO 8601格式时间戳，计数字段返回的是纯数值类型，这类值没有经过列表/站点的展示规则处理，适合做后端逻辑计算、跨系统数据同步。
• 带.后缀的字段，是经过站点渲染规则格式化后的最终展示值：SharePoint会按照当前列表配置的区域设置、时区、字段格式要求，对原始值做加工后返回。比如Created.返回的是已经转换为站点默认时区、符合站点日期格式配置的标准日期字符串，count.返回的是加了千分位分隔符、符合数值展示规则的计数结果，这类值和SharePoint页面上列表视图直接展示给用户的内容完全一致。

关于这类字段的权威性与准确性可以放心：

带.后缀的字段是RenderListDataAsStream端点的固定返回结构，从SharePoint Server 2013到最新版SharePoint Online的接口逻辑中一直存在，并非临时生成的非公开字段。它的数据源和对应不带点的原始字段完全一致，只是多了一层格式化处理，不存在数据失真的问题。

使用时需要注意三个规则：

1. 带.后缀的字段仅存在于RenderListDataAsStream的响应体中，不能将Created.这类带后缀的名称作为$select、$filter等参数传入其他SPO REST接口，否则会触发字段不存在的报错。
2. 日期类的带后缀字段已经做了站点时区转换，如果你业务逻辑需要统一使用UTC时间做跨时区计算，建议优先使用不带后缀的原始Created字段自行做时区转换，避免时间偏差。
3. 除了日期、计数字段外，所有存在“原始存储值/用户展示值”差异的字段（用户字段、查找字段、选项字段等）都会返回对应带.后缀的格式化值，比如Author.返回用户的显示名称，不带后缀的Author则返回包含用户ID、登录账号的结构化原始数据。

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