使用Excel Graph API设置单元格日期时，如何避免格式被自动修改？

这个问题我之前帮开发者排查过好几次，核心是Excel和Graph API对日期解析的区域依赖问题——当你发送2/1/2017这种格式的字符串时，Graph API默认会根据服务器区域或者工作簿的区域设置来解析，导致日和月被颠倒。下面给你几个靠谱的解决思路：

1. 使用Excel日期序列号（最精准无歧义） #

Excel本质上把日期存储为序列号（1900年1月1日为1，之后每天递增1），比如2017年2月1日对应的序列号是42769。直接发送序列号完全不会有格式混淆问题，还能配合numberFormat指定显示格式：

PATCH https://graph.microsoft.com/v1.0/me/drive/items/XXXXXXXX/workbook/worksheets/Sheet1/range(address='A1')
Content-Type: application/json

{
  "values": [[42769]],
  "numberFormat": [["m/d/yyyy"]]
}

提示：可以用Excel的DATEVALUE("2/1/2017")函数快速获取对应序列号

2. 用ISO 8601格式日期字符串+指定显示格式 #

发送标准的ISO 8601日期格式（YYYY-MM-DD），Graph API和Excel都能明确识别年-月-日的顺序，不会出现解析错误。同时通过numberFormat设置你想要的显示格式：

PATCH https://graph.microsoft.com/v1.0/me/drive/items/XXXXXXXX/workbook/worksheets/Sheet1/range(address='A1')
Content-Type: application/json

{
  "values": [["2017-02-01"]],
  "numberFormat": [["m/d/yyyy"]]
}

3. 先设置工作簿会话的区域设置 #

如果需要批量操作都使用统一的日期格式解析规则，可以先创建一个指定区域的工作簿会话，后续所有操作都带上会话ID，强制使用该区域的解析逻辑：

第一步：创建指定区域的会话 #

POST https://graph.microsoft.com/v1.0/me/drive/items/XXXXXXXX/workbook/createSession
Content-Type: application/json

{
  "persistChanges": true,
  "locale": "en-US"
}

返回结果里会包含id字段，这就是会话ID

第二步：带会话ID发送PATCH请求 #

在请求头里添加workbook-session-id: <你的会话ID>，然后发送日期设置请求：

PATCH https://graph.microsoft.com/v1.0/me/drive/items/XXXXXXXX/workbook/worksheets/Sheet1/range(address='A1')
Content-Type: application/json
workbook-session-id: <会话ID>

{
  "values": [["2/1/2017"]],
  "numberFormat": [["m/d/yyyy"]]
}

4. 避免使用formulas字段（改用values） #

你之前用的formulas字段会触发Excel的公式计算逻辑，这时候Excel会根据当前区域设置自动解析日期字符串。改用values字段直接设置单元格值，配合numberFormat控制显示，能避免不必要的自动解析。

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