接口简介：
通过经纬度查询全球各地区时间，包括各国当前时间或地区时间。
请求地址：
https://cn.apihz.cn/api/time/timejw.php
请求方式：
POST或GET。
请求参数：
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】
【经度】【lon】【是】【经度，例：lon=116.301444】
【纬度】【lat】【是】【纬度，例：lat=40.050923】
返回参数：
【名称】【参数】【说明】
【状态码】【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】【接口服务器时间】
GET请求示例：
https://cn.apihz.cn/api/time/timejw.php?id=88888888&key=88888888&lon=116.301444&lat=40.050923
注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。
POST请求示例：
请根据开发语言自行POST。
返回数据示例：
示例：{"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": 1780713716,
"datetime": "2026-06-06 02:41:56",
"weekday": "6",
"weekday_cn": "星期六"
},
"timezones": [{
"timezone": "Asia/Shanghai",
"timezone_cn": "上海（中国）",
"current_time": "2026-06-06 10:41:56",
"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-06-06 10:41:56"
}
}
}
参考资料(版权)：
https://www.apihz.cn/api/timetimejw.html
