| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 名称 | country | 是 | 支持查询所有国家,及特殊地区如夏威夷等。可传中文名称如:美国,英文名称如:United States,ISO2简称如:US,部分别名如:法兰西。例:country=美国 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功,400错误 |
| 信息提示 | msg | 信息提示 |
| 数据集 | data | 数据集 |
| 国家基础信息数据集 | data.country | 国家基础信息数据集 |
| 中文国家名 | data.country.cn | 中文国家名 |
| 英文国家名 | data.country.en | 英文国家名 |
| iso2代码 | data.country.iso2 | ISO 3166‑2 国家代码 |
| 首都纬度 | data.country.lat | 首都纬度 |
| 首都经度 | data.country.lng | 首都经度 |
| UTC范围 | data.country.utc_offset | 理论 UTC 范围 |
| 全球统一时间数据集 | data.utc_time | 全球统一时间数据集 |
| Unix 时间戳 | data.utc_time.timestamp | Unix 时间戳 |
| 格式化时间 | data.utc_time.datetime | 格式化时间 |
| 星期几 | data.utc_time.weekday | 星期几 |
| 中文星期 | data.utc_time.weekday_cn | 中文星期 |
| 国家所有时区数据集 | data.timezones | 该国家或地区所有时区数据集对象 |
| IANA 时区 | data.timezones.timezone | IANA 时区 ID |
| 时区中文名 | data.timezones.timezone_cn | 时区中文名 |
| 当地当前时间 | data.timezones.current_time | 当地当前时间 |
| UTC偏移 | data.timezones.offset | UTC 偏移 |
| 是否夏令时 | data.timezones.is_dst | 是否夏令时 |
| 理论标准时区数据集 | data.timezones.standard | 理论标准时区数据集 |
| 时区偏移名 | data.timezones.standard.name | 时区偏移名 |
| 偏移秒数 | data.timezones.standard.offset_seconds | 偏移秒数 |
| 偏移小时数 | data.timezones.standard.offset_hours | 偏移小时数 |
| 是否夏令时 | data.timezones.standard.is_dst | 是否夏令时 |
| iana时区数据集 | data.timezones.iana | iana时区数据集 |
| IANA 时区 | data.timezones.iana.name | IANA 时区 |
| 当前偏移 | data.timezones.iana.offset | 当前偏移 |
| 夏令时 | data.timezones.iana.is_dst | 夏令时 |
| 国家代码 | data.timezones.iana.country_code | 国家代码 |
| 国家中文名 | data.timezones.iana.country_cn | 国家中文名 |
| 国家英文名 | data.timezones.iana.country_en | 国家英文名 |
| 查询摘要数据集 | data.summary | 本次查询摘要数据集 |
| 时区数量 | data.summary.timezone_count | 该国家或地区所有时区数量 |
| 是否多时区 | data.summary.has_multiple_timezones | 是否多时区 |
| 服务器时间 | data.summary.query_time | 接口服务器时间 |
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"msg": "success",
"data": {
"country": {
"cn": "中国",
"en": "China",
"iso2": "CN",
"lat": 39.9042,
"lng": 116.4074,
"utc_offset": "UTC+8"
},
"utc_time": {
"timestamp": 1780027780,
"datetime": "2026-05-29 04:09:40",
"weekday": "5",
"weekday_cn": "星期五"
},
"timezones": [{
"timezone": "Asia/Shanghai",
"timezone_cn": "上海(中国)",
"current_time": "2026-05-29 12:09:40",
"offset": "UTC+8",
"is_dst": false,
"standard": {
"name": "UTC+8",
"offset_seconds": 28800,
"offset_hours": 8,
"is_dst": false
},
"iana": {
"name": "Asia/Shanghai",
"offset": "UTC+8",
"is_dst": false,
"country_code": "CN",
"country_cn": "中国",
"country_en": "China"
}
}],
"summary": {
"timezone_count": 1,
"has_multiple_timezones": false,
"query_time": "2026-05-29 12:09:40"
}
}
}
示例:
{
"code": 200,
"msg": "success",
"data": {
"country": {
"cn": "美国",
"en": "United States",
"iso2": "US",
"lat": 38.9072,
"lng": -77.0369,
"utc_offset": "UTC-5 ~ UTC-10"
},
"utc_time": {
"timestamp": 1780027794,
"datetime": "2026-05-29 04:09:54",
"weekday": "5",
"weekday_cn": "星期五"
},
"timezones": [{
"timezone": "America/New_York",
"timezone_cn": "纽约(美国东部)",
"current_time": "2026-05-29 00:09:54",
"offset": "UTC-4",
"is_dst": true,
"standard": {
"name": "UTC-4",
"offset_seconds": -14400,
"offset_hours": -4,
"is_dst": true
},
"iana": {
"name": "America/New_York",
"offset": "UTC-4",
"is_dst": true,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "America/Chicago",
"timezone_cn": "芝加哥(美国中部)",
"current_time": "2026-05-28 23:09:54",
"offset": "UTC-5",
"is_dst": true,
"standard": {
"name": "UTC-5",
"offset_seconds": -18000,
"offset_hours": -5,
"is_dst": true
},
"iana": {
"name": "America/Chicago",
"offset": "UTC-5",
"is_dst": true,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "America/Denver",
"timezone_cn": "丹佛(美国山地)",
"current_time": "2026-05-28 22:09:54",
"offset": "UTC-6",
"is_dst": true,
"standard": {
"name": "UTC-6",
"offset_seconds": -21600,
"offset_hours": -6,
"is_dst": true
},
"iana": {
"name": "America/Denver",
"offset": "UTC-6",
"is_dst": true,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "America/Phoenix",
"timezone_cn": "凤凰城(美国亚利桑那)",
"current_time": "2026-05-28 21:09:54",
"offset": "UTC-7",
"is_dst": false,
"standard": {
"name": "UTC-7",
"offset_seconds": -25200,
"offset_hours": -7,
"is_dst": false
},
"iana": {
"name": "America/Phoenix",
"offset": "UTC-7",
"is_dst": false,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "America/Los_Angeles",
"timezone_cn": "洛杉矶(美国太平洋)",
"current_time": "2026-05-28 21:09:54",
"offset": "UTC-7",
"is_dst": true,
"standard": {
"name": "UTC-7",
"offset_seconds": -25200,
"offset_hours": -7,
"is_dst": true
},
"iana": {
"name": "America/Los_Angeles",
"offset": "UTC-7",
"is_dst": true,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "America/Anchorage",
"timezone_cn": "安克雷奇(阿拉斯加)",
"current_time": "2026-05-28 20:09:54",
"offset": "UTC-8",
"is_dst": true,
"standard": {
"name": "UTC-8",
"offset_seconds": -28800,
"offset_hours": -8,
"is_dst": true
},
"iana": {
"name": "America/Anchorage",
"offset": "UTC-8",
"is_dst": true,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}, {
"timezone": "Pacific/Honolulu",
"timezone_cn": "檀香山(夏威夷)",
"current_time": "2026-05-28 18:09:54",
"offset": "UTC-10",
"is_dst": false,
"standard": {
"name": "UTC-10",
"offset_seconds": -36000,
"offset_hours": -10,
"is_dst": false
},
"iana": {
"name": "Pacific/Honolulu",
"offset": "UTC-10",
"is_dst": false,
"country_code": "US",
"country_cn": "美国",
"country_en": "United States"
}
}],
"summary": {
"timezone_count": 7,
"has_multiple_timezones": true,
"query_time": "2026-05-29 12:09:54"
}
}
}
2026-05-29 10:36:04 - 新增接口。
查询全球所有国家及特殊地区当前时间。
| 调用权限 | 非定制接口直接使用 |
| 单价/次 | 免费[无上限] |
| 单日[所有用户之和] | 999999999 |
| 1分钟并发[所有用户之和] | 999999999 |
| 1小时并发[所有用户之和] | 999999999 |
| 频次限制[注册用户] | 10次/分钟|每日无上限 |
| 频次限制[钻石会员] | 最高8000+次/分钟|每日无上限 |
| 频次限制[定制频次] | 联系我们定制 |
| 请求方式 | GET/POST |
| 返回格式 | JSON |
| 编码格式 | UTF-8 |
| 浏览量 | 98 |
| 今日总计调用 | 3317 |
| 昨日总计调用 | 3301 |
| 历史总计调用 | 35773 |
| 今日排名 | 44 |
| 总排名 | 260 |
| 自检启用状态 | 未开启 |
| 自检节点 | / |
| 自检线路 | 彩钻接口线路 |
| 自检时间 | / |
| 自检耗时 | / 毫秒 |
| 自检状态 | / |
| 历史自检成功数 | / 次 |
| 历史自检失败数 | / 次 |
| 历史自检成功率 | / % |
| 今日自检成功数 | / 次 |
| 今日自检失败数 | / 次 |
| 今日自检成功率 | / % |