其他说明

更新于 2026-01-13

本页说明接口时间参数的统一规范，重点包含 ISO 8601 格式、UTC 表达与北京时间转换示例。

时间格式

ISO 8601 是一种国际标准化组织（ISO）制定的日期和时间格式，广泛应用于数据交换、计算机编程和国际标准中。它具有清晰、一致和易于解析的特点。

本项目中所有接口时间传参，需要遵循 ISO 8601 国际标准的时间格式。

格式解析：

以北京时间 2025-06-09 16:00:00 转为 UTC 时间 2025-06-09T08:00:00.000Z 为例

  1. 格式说明：
  • 2025-06-09：表示日期，其中“2025”是年份，“06”是月份（6月），“09”是日期（9日）。
  • T08:00:00.000Z：表示时间。
  • T是日期和时间的分隔符。
  • 08:00:00表示 UTC 时间 08 点 0 分 0 秒，北京时间 16 点 0 分 0 秒（相差 8 时区）。
  • .000表示毫秒部分，这里是 0 毫秒。
  • Z表示时区，是 UTC（协调世界时）的标识，表示这个时间是基于 UTC 时间。UTC 时间是全球通用的时间标准，用于航空、航海、通信、科学研究等领域，确保全球范围内的协调和一致性。
  1. 时间转换：
  • 时区划分：全球的时区都是以 UTC 时间为基准进行划分的。例如，北京时间是 UTC+8，即比 UTC 时间快 8 小时；伦敦时间（夏令时除外）是 UTC+0。
  • 由于数据存储和现实生活中使用时间存在时差，所以我们在传给接口时需要进行时间转换。以北京时间为例，北京时间比 UTC 时间快 8 小时。
  • 因此北京时间 2025-06-09 16:00:00 转为传参的 UTC 时间为 2025-06-09T08:00:00.000Z