跳转到内容

时区、币种与官方标准

timezone 和 currency 使用国际标准标识。接口会检查代码是否存在于发布时固定的官方名单,而不仅检查字符串格式。

填写 IANA Time Zone Database 中的时区标识,大小写必须准确。

示例 说明
America/Los_Angeles 美国洛杉矶地区时区
Asia/Shanghai 中国上海地区时区
Europe/London 英国伦敦地区时区
Etc/UTC UTC

地区时区包含当地历史和夏令时规则,不能用一个固定 GMT 偏移代替。比如 America/Los_Angeles 不能全年当作固定的 UTC−8 使用。

不再接受 GMT -8:00、+08:00 或自行编写的时区名称。不会自动猜测固定偏移对应哪个地区。IANA 官方别名会规范化,例如 US/Pacific 保存为 America/Los_Angeles。

填写 ISO 4217 三字母大写代码,不使用币种中文名称、货币符号或数字代码。

正确示例 含义 不接受的写法
USD 美元 usd、$、840
CNY 人民币 RMB、人民币
EUR 欧元 eur、€

接口以 ISO 4217 官方维护机构 SIX 的 List One: Current Currency & Funds 为校验名单。ZZZ 等不存在的代码会被拒绝;标准名单有效与后续业务支持范围是两回事。

数据 当前固定版本
IANA 时区数据库 2026f
SIX ISO 4217 List One 发布日期 2026-09-17

标准数据随接口版本更新,不会在每次请求时在线下载。官方名单今后有变更时,请以本文公布的接口版本为准。

非法时区或币种返回 HTTP 400,错误码为 INVALID_EXTERNAL_ORDER。请修正后提交;不要靠更换请求 ID 重试同一份错误数据。