两种时间表示方式
你会注意到接口里存在两种不同粒度的时间表示:- 日期 + 时间分离(
date+time):用于赛程类字段,date是YYYY-MM-DD、time是HH:mm,两者都是 UTC,需要合并使用时自行拼接,例如2026-07-15T19:00:00Z。 - 单一 ISO-8601 时刻(带
Z后缀):用于实时 feed 的updated_at和响应信封的meta.timestamp,格式已经是完整的日期时间戳,可以直接传给大多数语言的日期解析函数。
本地化展示示例
以下示例展示如何把接口返回的 UTC 时间转换为用户本地时间:入参与出参日期均为 ISO
YYYY-MM-DD;time 与 date 同为 UTC,需展示本地时间请由客户端按用户时区换算。这一约定适用于文档中出现的所有接口,各接口页不再重复说明。