RESTful API设计 - 传递日期的最佳实践

Question

在API中共享日期的最佳做法是什么？

最好是以类似SQL的日期时间格式分享日期 - 'YYY-MM-DD HH：MM：SS'，其中嵌入了可选的时区吗？

或者最好使用基于UTC的毫秒？

Answer 1

我更喜欢将时间编码为完整的ISO 8601日期，但是我的代码只能在UTC时区生成它们。如果您有一个好日期解析库（例如，Jodatime for Java），接受完整的ISO 8601并不是特别困难，并且它们至少在某种程度上是可读的。 （某些时代瞬间的抵消并不像人们容易阅读的那样。）

Answer 2

这取决于你，但是，除非你正在做某种日历应用程序，否则我不打扰支持完整的ISO格式，因为在处理时区，夏令时等时解析它们会很快变得非常复杂。将它们作为UTC传递几乎总是足够好，并且使用您的API的程序员很容易将他们拥有的任何日期转换为此格式。