Timezone Lookup

The Timezone API covers coordinates, IPs, cities, local-time conversion, DST, business-hours overlap, timezone boundaries, and scheduling helpers. Every endpoint is designed around rich timezone and time metadata so callers get multiple ready-to-use time formats in one response.

原始信息汇总

数据集概述：Timezone Lookup

简介 Timezone Lookup 是由 APIGrid 提供的一个免费的 REST API 服务，旨在帮助开发者将时区和时间相关服务集成到应用程序中。它支持通过多种方式解析时区及时间信息，包括坐标、IP 地址、城市名称，并提供时区转换、夏令时处理、工作时间查找、时区边界查询以及跨时区日程优化等功能。

主要功能与端点 该 API 提供了以下 11 个核心端点，所有请求均需通过 Authorization: Bearer YOUR_API_KEY 头进行身份验证：

方法	端点	功能描述
GET	/v1/timezone/lookup	根据地理坐标（经纬度）获取时区信息。
GET	/v1/timezone/ip	根据 IPv4 或 IPv6 地址获取时区及位置信息。
GET	/v1/timezone/city	根据城市名称（可选国家代码）获取时区信息。
GET	/v1/timezone/time/now	获取指定 IANA 时区的当前时间。
GET	/v1/timezone/time/convert	将源时区的日期时间转换为目标时区的时间。
GET	/v1/timezone/time/business-hours	检查指定时区的当前时间是否处于标准工作时间内。
GET	/v1/timezone/time/overlap	计算两个时区之间的工作时间重叠窗口。
GET	/v1/timezone/boundary	获取指定 IANA 时区的地理边界（GeoJSON 格式）。
GET	/v1/timezone/list	列出所有支持的 IANA 时区。
GET	/v1/timezone/list/country	根据国家代码列出该国下的所有时区。
POST	/v1/timezone/schedule/optimize	分析最多100个时区的工作时间，推荐最佳会议时间窗。

响应数据结构 大多数端点返回一个一致的 JSON 对象，包含以下三个主要部分：

• coordinates 对象：包含地理位置的 latitude（纬度）和 longitude（经度）。
• timezone 对象：
  • id：IANA 时区标识（如 Europe/London）。
  • name：时区常见名称。
  • abbreviation：当前时区缩写（如 BST）。
  • offset：当前 UTC 偏移（如 +01:00）。
  • offsetMinutes：当前 UTC 偏移（以分钟为单位）。
  • isDstActive：当前是否处于夏令时。
  • dstObserved：该时区是否观察夏令时。
• time 对象：
  • iso8601：UTC 时间的 ISO 8601 格式。
  • rfc3339：本地时间的 RFC 3339 格式。
  • unix / unixMs：Unix 时间戳（秒/毫秒）。
  • localDate / localTime24 / localTime12 / localDateTime：本地日期及时间表示。
  • weekday：星期几。
  • isWeekend：是否为周末。
  • weekendDays：被视为周末的天数列表。
  • dayPeriod：一天中的时段（如 Afternoon）。

错误处理 API 使用标准 HTTP 状态码：

状态码	说明
400	请求参数无效（如经纬度超出范围）。
401	API 密钥缺失或无效。
404	未找到匹配的时区、城市或国家。
429	请求频率超过套餐限制。
500	服务器内部错误。

速率限制

• Starter 计划：每分钟 60 次请求。
• Growth 计划：每分钟 180 次请求。
• Enterprise 计划：自定义限制。