5 个关于 API 中日期和时间设计规则

时间:2023-03-09 15:46:22
5 个关于 API 中日期和时间设计规则

规则 #1 使用ISO-8601格式作为你的日期格式

ISO 8601 解决了很多问题,包括:

  • 自然排序 - 简单和优雅,免去多余的工作即可实现排序
  • 时区偏移 - 代表用户的地点和时区在日益增长的全球化和移动世界中越来越重要。
  • 地区中立性 - 想象一下噩梦一般的日期 2/3/4。这个日期随着你所处美国,欧洲或者其他地方而有不同的含义...这个日期在美国代表Feb 3, 2004,或者在其他地方代表Mar 2, 2004。在ISO 8601条款中,2004-02-03去掉了这些含糊的可能性。
  • 在不同的编程语言中都得到广泛的支持 - 即使不是所有的语言都使用这个标准作为默认值(例如Java),但是它们基本都有成熟的库来转化 ISO 8601格式。

规则#2: 接受任何的时区

规则#3:用UTC(Coordinated Universal Time 世界同一时间)格式存储

规则#4 使用UTC格式作为返回值格式

规则#5 如果你不需要时间的话,不要使用它

5 个关于 API 中日期和时间设计规则-云栖社区-阿里云