跳转到主要内容
为了避免跨时区的歧义,AnySport 所有时间字段统一使用 UTC,无论是查询参数还是响应字段。客户端在展示给终端用户之前,需要自行按用户所在时区做本地化转换,接口本身不做任何时区推断或转换。

两种时间表示方式

你会注意到接口里存在两种不同粒度的时间表示:
  • 日期 + 时间分离(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,需展示本地时间请由客户端按用户时区换算。这一约定适用于文档中出现的所有接口,各接口页不再重复说明。