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

时间:2019-01-14 08:29:02

标签: rest date-formatting

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

因此日期字段将出现在http有效内容的正文中。

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

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

更新:此问题被标记为与this重复,但并非如此,因为我询问日期字段的PAYLOAD的建议日期格式,而另一篇文章讨论了GET Request的格式URI!

2 个答案:

答案 0 :(得分:2)

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

考虑到它的广泛采用和公认的标准,我想这是一条路,特别是如果您的API被未知的客户端应用程序占用的话。

答案 1 :(得分:1)

经过一些研究,如 json-schema.org 中所建议的那样,日期时间格式是ISO-8601的替代方法。

Here是相关文档,它紧随

  

RFC-3339

(这是ISO-8601的“配置文件”)

这种标准格式的优点是

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