Notion API的日期格式是什么？调用时日期值无效报错如何解决？

标准日期格式要求 #

Notion API 要求所有日期值必须符合 ISO 8601 规范，分两种使用场景：

• 仅传入日期（不带时间）：使用YYYY-MM-DD格式，用横杠分隔年月日，月份、日期不足两位时必须补前导零，正确示例：2021-05-14
• 传入带时间的日期：使用完整的带分隔符的ISO 8601格式，结构为YYYY-MM-DDTHH:mm:ssZ，其中T是日期与时间的固定分隔符，末尾Z代表UTC时区，如需指定其他时区可替换为时区偏移值，东八区示例：2021-05-14T00:00:00+08:00

同时注意日期字段的传参结构不能直接写字符串，需要嵌套在对应属性的date.start字段中，传参示例：

{
  "properties": {
    "Bal": {
      "date": {
        "start": "2021-05-14"
      }
    }
  }
}

本次报错原因 #

你尝试的所有格式均不符合校验规则：

• 所有使用斜杠/作为分隔符的格式不被支持
• 月日顺序颠倒的2021/14/05本身为无效日期
• 用空格分隔日期和时间的格式不符合ISO 8601规范

关于官方文档标注的说明 #

Notion官方文档实际已在「日期对象（Date Object）」的参数约束章节明确标注了ISO 8601的格式要求，多数用户未找到该说明是因为规则没有放在通用入门指南中，而是嵌套在数据库属性字段的专项说明里，容易被忽略。

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