世界时间 API

查询世界各地当前时间、UTC 偏移与夏令时,或把某个时区的时间换算到其他时区(按 IANA 时区规则,自动处理夏令时)

数据来源:本地计算(Intl 时区数据库)

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data },支持跨域,免注册每天可免费调用 100 次,注册后每天 10000 次。

世界各地当前时间

GET /api/time/world

请求参数

  • zones:逗号分隔的时区,支持 IANA 名(如 Asia/Tokyo)、常用城市中文名(北京、东京、伦敦、纽约、洛杉矶、巴黎、悉尼等)或 UTC+8 形式,最多 20 个,示例 北京,东京,伦敦,纽约

返回字段

  • utc(string):当前 UTC 时间,ISO 8601
  • timestamp(number):当前 Unix 时间戳(秒)
  • zones(array):各时区当前时间,顺序同请求
  • zones[].zone(string):IANA 时区名,如 Asia/Tokyo
  • zones[].city(string|null):代表城市中文名(内置常用城市表,未收录时为 null)
  • zones[].datetime(string):当地日期时间 YYYY-MM-DD HH:mm:ss
  • zones[].date(string):当地日期 YYYY-MM-DD
  • zones[].time(string):当地时间 HH:mm
  • zones[].weekday(string):当地星期几,如 星期一
  • zones[].offset(string):相对 UTC 的偏移,如 +08:00、-04:00、+05:45
  • zones[].offsetMinutes(number):相对 UTC 的偏移(分钟,东区为正)
  • zones[].isDST(boolean):当时是否处于夏令时
  • zones[].iso(string):带偏移的 ISO 8601 当地时间,如 2026-10-01T09:00:00+08:00

时区换算:把某地时间换算成其他时区

GET /api/time/convert

请求参数

  • time(必填):要换算的当地时间 YYYY-MM-DD HH:mm(也可只传 HH:mm 表示 from 时区的今天),示例 2026-10-01 09:00
  • from:源时区(IANA 名或城市中文名),示例 北京
  • to:目标时区,逗号分隔的时区,支持 IANA 名(如 Asia/Tokyo)、常用城市中文名(北京、东京、伦敦、纽约、洛杉矶、巴黎、悉尼等)或 UTC+8 形式,最多 20 个,示例 纽约,伦敦,东京

返回字段

  • from(object):源时区的时间信息
  • from.zone(string):IANA 时区名,如 Asia/Tokyo
  • from.city(string|null):代表城市中文名(内置常用城市表,未收录时为 null)
  • from.datetime(string):当地日期时间 YYYY-MM-DD HH:mm:ss
  • from.date(string):当地日期 YYYY-MM-DD
  • from.time(string):当地时间 HH:mm
  • from.weekday(string):当地星期几,如 星期一
  • from.offset(string):相对 UTC 的偏移,如 +08:00、-04:00、+05:45
  • from.offsetMinutes(number):相对 UTC 的偏移(分钟,东区为正)
  • from.isDST(boolean):当时是否处于夏令时
  • from.iso(string):带偏移的 ISO 8601 当地时间,如 2026-10-01T09:00:00+08:00
  • from.ambiguous(boolean):该时间是否因夏令时结束(时钟拨慢)而出现两次;为 true 时按第一次出现(夏令时)计算
  • utc(string):对应的 UTC 时间,ISO 8601
  • timestamp(number):对应的 Unix 时间戳(秒)
  • results(array):各目标时区的换算结果
  • results[].zone(string):IANA 时区名,如 Asia/Tokyo
  • results[].city(string|null):代表城市中文名(内置常用城市表,未收录时为 null)
  • results[].datetime(string):当地日期时间 YYYY-MM-DD HH:mm:ss
  • results[].date(string):当地日期 YYYY-MM-DD
  • results[].time(string):当地时间 HH:mm
  • results[].weekday(string):当地星期几,如 星期一
  • results[].offset(string):相对 UTC 的偏移,如 +08:00、-04:00、+05:45
  • results[].offsetMinutes(number):相对 UTC 的偏移(分钟,东区为正)
  • results[].isDST(boolean):当时是否处于夏令时
  • results[].iso(string):带偏移的 ISO 8601 当地时间,如 2026-10-01T09:00:00+08:00
  • results[].dayDiff(number):与源时区日期相差的天数:1 为次日,-1 为前一天,0 为同一天
  • results[].diffHours(number):该时区比源时区快多少小时(负数为慢),如 -12
  • results[].text(string):一句话中文结果,如 纽约 2026-09-30 21:00 星期三(前一天)