rest api 有效负载字段的正确日期格式是什么?

What is the proper date format for a rest api payload field?

我们正在设计一个 rest api,它将在 get 和 post 请求中为日期字段提供服务。

因此日期字段将出现在 http 负载的 正文 中。

据我所知(如果我错了请纠正我)json 中没有日期数据类型定义,它只是字符串。因此,这个字符串日期字段的格式取决于实现。

但是对于这种情况没有最佳实践吗?我发现很难找到指南。你能帮忙吗?

更新:这个问题被标记为与 this 重复,但它不是,因为我询问了日期字段的 PAYLOAD 的推荐日期格式,而另一个 post 讨论GET 请求 URI 的格式!

您可能会发现最常用的格式是 ISO-8601

鉴于它是一个被广泛采用和认可的标准,我认为这是可行的方法,尤其是当您的 API 被未知的客户端应用程序使用时。

经过一些研究,ISO-8601 的替代方案是 日期时间格式,如 json-schema.org.

Here 是相关文档,它遵循

RFC-3339

(这是 ISO-8601 的 "profile")

这种标准格式的优点是

  1. 可以轻松验证
  2. 可以明确记录