TimeZoneDB · 时区与本地时间API

TimeZoneDB官方API可按时区名或经纬度查询本地时间、UTC偏移和夏令时信息，需API key；城市/IP查询标为Premium。响应支持XML或JSON。仅文档整理、未调用；页面列商业重用量套餐起价，但具体额度、HTTPS支持及实际许可条件未验证。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-a7eb7f0e180bee1bb437e6f1
Card version: 2
Updated: 2026-10-24T17:43:06.0028625+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

Reference to use get time zone API

Inputs

key和by必填；by支持zone、position、city、ip，城市/IP示例明确标Premium。
format可选xml或json，默认xml；fields用逗号分隔选择字段。
time可提供UTC Unix时间，默认当前UTC；city方式另需country和city，可选region/page，完整分页语义未核。

Outputs

status为OK或FAILED，message为错误信息；时区数据含国家、zoneName、abbreviation、gmtOffset（秒）、dst、zoneStart/zoneEnd等。
formatted为本地时间字符串；文档把timestamp称本地Unix数值并说明减gmtOffset得UTC，不能直接按标准UTC Unix时间处理。

Invocation and authentication

unknown

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u5FC5\u987B\u4F7F\u7528\u6CE8\u518C\u8D26\u6237\u53D6\u5F97\u7684\u552F\u4E00key\u67E5\u8BE2\u53C2\u6570\uFF1B\u6B64\u8F6E\u672A\u6CE8\u518C\u6216\u4F7F\u7528\u771F\u5B9E\u5BC6\u94A5\u3002\u5B98\u65B9\u672C\u9875\u793A\u4F8B\u662FHTTP\uFF0CHTTPS\u4E0E\u5BC6\u94A5\u4F20\u8F93\u4FDD\u62A4\u672A\u9A8C\u8BC1\u3002"
  },
  "command": null,
  "entry_url": null,
  "kind": "http_api",
  "method": "GET",
  "request_example": null,
  "requirements": [
    "\u6709\u6548TimeZoneDB API key\u53CA\u6240\u9009\u67E5\u8BE2\u65B9\u5F0F\u5BF9\u5E94\u7684\u6743\u9650/\u8BA2\u9605\u3002",
    "by=zone\u9700zone\uFF1Bby=position\u9700lat/lng\uFF1Bcity/ip\u65B9\u5F0F\u5E94\u6838Premium\u4E13\u7528\u5730\u5740\u548C\u6743\u9650\u3002",
    "\u4E0D\u8981\u5C06\u6587\u6863\u6837\u4F8B\u65F6\u95F4\u5F53\u5B9E\u9645\u54CD\u5E94\u6216\u5F53\u524D\u65F6\u533A\u72B6\u6001\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u672C\u9875\u5217heavy/commercial\u7528\u9014Premium\u670D\u52A1as low as US$4.20/\u6708\uFF0C\u4F46\u672A\u5217\u5177\u4F53\u5957\u9910\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8BA1\u8D39\u6761\u4EF6\uFF1B\u6570\u636E\u5E93\u5F00\u653E\u8BB8\u53EF\u4E0D\u7B49\u4E8E\u6258\u7BA1API\u65E0\u9650\u514D\u8D39\u3002",
  "source_url": "https://timezonedb.com/references/get-time-zone"
}

{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u67E5\u8BE2\u4F1A\u53D1\u9001API key\u53CA\u53EF\u80FD\u7684\u5750\u6807\u3001\u57CE\u5E02\u6216IP\u5730\u5740\uFF1B\u65E5\u5FD7\u3001\u7559\u5B58\u3001\u9690\u79C1\u548CHTTPS\u652F\u6301\u672A\u6838\u3002\u9875\u811A\u58F0\u660E\u6570\u636E\u5E93CC BY3.0\uFF0C\u987B\u533A\u5206\u6570\u636E\u5E93\u8BB8\u53EF\u4E0EAPI\u670D\u52A1\u6761\u6B3E\u3002\u672C\u8F6E\u672A\u53D1\u9001\u67E5\u8BE2\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

城市和IP查询为Premium；regionName/cityName字段也标Premium，不能从示例非空推断所有套餐可用。
参数表及响应页的分页阈值描述不一致，具体page/totalPage行为未验证。
当前示例为HTTP；不能未经验证改成HTTPS或保证密钥传输安全。
未核速率、请求额度、数据更新及时性、历史日期覆盖或SLA。

Unknowns

实际认证、套餐权限、调用额度、完整价格和服务条款未知。
HTTPS支持、日志留存、数据更新与时区计算准确性未验证。
未实际查询IP、坐标或执行能力测试。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:37:19.5418592\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://timezonedb.com/references/get-time-zone"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u67E5\u8BE2\u4F1A\u53D1\u9001API key\u53CA\u53EF\u80FD\u7684\u5750\u6807\u3001\u57CE\u5E02\u6216IP\u5730\u5740\uFF1B\u65E5\u5FD7\u3001\u7559\u5B58\u3001\u9690\u79C1\u548CHTTPS\u652F\u6301\u672A\u6838\u3002\u9875\u811A\u58F0\u660E\u6570\u636E\u5E93CC BY3.0\uFF0C\u987B\u533A\u5206\u6570\u636E\u5E93\u8BB8\u53EF\u4E0EAPI\u670D\u52A1\u6761\u6B3E\u3002\u672C\u8F6E\u672A\u53D1\u9001\u67E5\u8BE2\u3002"
  },
  "description": "Reference to use get time zone API",
  "inputs": [
    "key\u548Cby\u5FC5\u586B\uFF1Bby\u652F\u6301zone\u3001position\u3001city\u3001ip\uFF0C\u57CE\u5E02/IP\u793A\u4F8B\u660E\u786E\u6807Premium\u3002",
    "format\u53EF\u9009xml\u6216json\uFF0C\u9ED8\u8BA4xml\uFF1Bfields\u7528\u9017\u53F7\u5206\u9694\u9009\u62E9\u5B57\u6BB5\u3002",
    "time\u53EF\u63D0\u4F9BUTC Unix\u65F6\u95F4\uFF0C\u9ED8\u8BA4\u5F53\u524DUTC\uFF1Bcity\u65B9\u5F0F\u53E6\u9700country\u548Ccity\uFF0C\u53EF\u9009region/page\uFF0C\u5B8C\u6574\u5206\u9875\u8BED\u4E49\u672A\u6838\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u5FC5\u987B\u4F7F\u7528\u6CE8\u518C\u8D26\u6237\u53D6\u5F97\u7684\u552F\u4E00key\u67E5\u8BE2\u53C2\u6570\uFF1B\u6B64\u8F6E\u672A\u6CE8\u518C\u6216\u4F7F\u7528\u771F\u5B9E\u5BC6\u94A5\u3002\u5B98\u65B9\u672C\u9875\u793A\u4F8B\u662FHTTP\uFF0CHTTPS\u4E0E\u5BC6\u94A5\u4F20\u8F93\u4FDD\u62A4\u672A\u9A8C\u8BC1\u3002"
    },
    "command": null,
    "entry_url": null,
    "kind": "http_api",
    "method": "GET",
    "request_example": null,
    "requirements": [
      "\u6709\u6548TimeZoneDB API key\u53CA\u6240\u9009\u67E5\u8BE2\u65B9\u5F0F\u5BF9\u5E94\u7684\u6743\u9650/\u8BA2\u9605\u3002",
      "by=zone\u9700zone\uFF1Bby=position\u9700lat/lng\uFF1Bcity/ip\u65B9\u5F0F\u5E94\u6838Premium\u4E13\u7528\u5730\u5740\u548C\u6743\u9650\u3002",
      "\u4E0D\u8981\u5C06\u6587\u6863\u6837\u4F8B\u65F6\u95F4\u5F53\u5B9E\u9645\u54CD\u5E94\u6216\u5F53\u524D\u65F6\u533A\u72B6\u6001\u3002"
    ]
  },
  "limitations": [
    "\u57CE\u5E02\u548CIP\u67E5\u8BE2\u4E3APremium\uFF1BregionName/cityName\u5B57\u6BB5\u4E5F\u6807Premium\uFF0C\u4E0D\u80FD\u4ECE\u793A\u4F8B\u975E\u7A7A\u63A8\u65AD\u6240\u6709\u5957\u9910\u53EF\u7528\u3002",
    "\u53C2\u6570\u8868\u53CA\u54CD\u5E94\u9875\u7684\u5206\u9875\u9608\u503C\u63CF\u8FF0\u4E0D\u4E00\u81F4\uFF0C\u5177\u4F53page/totalPage\u884C\u4E3A\u672A\u9A8C\u8BC1\u3002",
    "\u5F53\u524D\u793A\u4F8B\u4E3AHTTP\uFF1B\u4E0D\u80FD\u672A\u7ECF\u9A8C\u8BC1\u6539\u6210HTTPS\u6216\u4FDD\u8BC1\u5BC6\u94A5\u4F20\u8F93\u5B89\u5168\u3002",
    "\u672A\u6838\u901F\u7387\u3001\u8BF7\u6C42\u989D\u5EA6\u3001\u6570\u636E\u66F4\u65B0\u53CA\u65F6\u6027\u3001\u5386\u53F2\u65E5\u671F\u8986\u76D6\u6216SLA\u3002"
  ],
  "outputs": [
    "status\u4E3AOK\u6216FAILED\uFF0Cmessage\u4E3A\u9519\u8BEF\u4FE1\u606F\uFF1B\u65F6\u533A\u6570\u636E\u542B\u56FD\u5BB6\u3001zoneName\u3001abbreviation\u3001gmtOffset\uFF08\u79D2\uFF09\u3001dst\u3001zoneStart/zoneEnd\u7B49\u3002",
    "formatted\u4E3A\u672C\u5730\u65F6\u95F4\u5B57\u7B26\u4E32\uFF1B\u6587\u6863\u628Atimestamp\u79F0\u672C\u5730Unix\u6570\u503C\u5E76\u8BF4\u660E\u51CFgmtOffset\u5F97UTC\uFF0C\u4E0D\u80FD\u76F4\u63A5\u6309\u6807\u51C6UTC Unix\u65F6\u95F4\u5904\u7406\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u9875\u5217heavy/commercial\u7528\u9014Premium\u670D\u52A1as low as US$4.20/\u6708\uFF0C\u4F46\u672A\u5217\u5177\u4F53\u5957\u9910\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8BA1\u8D39\u6761\u4EF6\uFF1B\u6570\u636E\u5E93\u5F00\u653E\u8BB8\u53EF\u4E0D\u7B49\u4E8E\u6258\u7BA1API\u65E0\u9650\u514D\u8D39\u3002",
    "source_url": "https://timezonedb.com/references/get-time-zone"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:37:19.5418592\u002B00:00",
      "title": "Reference: Get Time Zone - TimeZoneDB",
      "url": "https://timezonedb.com/references/get-time-zone"
    }
  ],
  "summary": "TimeZoneDB\u5B98\u65B9API\u53EF\u6309\u65F6\u533A\u540D\u6216\u7ECF\u7EAC\u5EA6\u67E5\u8BE2\u672C\u5730\u65F6\u95F4\u3001UTC\u504F\u79FB\u548C\u590F\u4EE4\u65F6\u4FE1\u606F\uFF0C\u9700API key\uFF1B\u57CE\u5E02/IP\u67E5\u8BE2\u6807\u4E3APremium\u3002\u54CD\u5E94\u652F\u6301XML\u6216JSON\u3002\u4EC5\u6587\u6863\u6574\u7406\u3001\u672A\u8C03\u7528\uFF1B\u9875\u9762\u5217\u5546\u4E1A\u91CD\u7528\u91CF\u5957\u9910\u8D77\u4EF7\uFF0C\u4F46\u5177\u4F53\u989D\u5EA6\u3001HTTPS\u652F\u6301\u53CA\u5B9E\u9645\u8BB8\u53EF\u6761\u4EF6\u672A\u9A8C\u8BC1\u3002",
  "tags": [
    "TimeZoneDB",
    "\u65F6\u533A",
    "\u672C\u5730\u65F6\u95F4",
    "\u590F\u4EE4\u65F6",
    "HTTP API",
    "API key",
    "Premium"
  ],
  "terms_url": null,
  "title": "TimeZoneDB \u00B7 \u65F6\u533A\u4E0E\u672C\u5730\u65F6\u95F4API",
  "unknowns": [
    "\u5B9E\u9645\u8BA4\u8BC1\u3001\u5957\u9910\u6743\u9650\u3001\u8C03\u7528\u989D\u5EA6\u3001\u5B8C\u6574\u4EF7\u683C\u548C\u670D\u52A1\u6761\u6B3E\u672A\u77E5\u3002",
    "HTTPS\u652F\u6301\u3001\u65E5\u5FD7\u7559\u5B58\u3001\u6570\u636E\u66F4\u65B0\u4E0E\u65F6\u533A\u8BA1\u7B97\u51C6\u786E\u6027\u672A\u9A8C\u8BC1\u3002",
    "\u672A\u5B9E\u9645\u67E5\u8BE2IP\u3001\u5750\u6807\u6216\u6267\u884C\u80FD\u529B\u6D4B\u8BD5\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:37:19.5418592\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://timezonedb.com/references/get-time-zone"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-a7eb7f0e180bee1bb437e6f1",
  "version": 2,
  "source_url": "https://timezonedb.com/references/get-time-zone",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://timezonedb.com/references/get-time-zone",
    "final_url": "https://timezonedb.com/references/get-time-zone",
    "status_code": 200,
    "title": "Reference: Get Time Zone - TimeZoneDB",
    "description": "Reference to use get time zone API",
    "checked_at": "2026-10-24T17:37:19.5418592\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:37:22.1410855\u002B00:00",
  "updated_at": "2026-10-24T17:43:06.0028625\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-a7eb7f0e180bee1bb437e6f1?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-a7eb7f0e180bee1bb437e6f1?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u5730\u7406\u4E0E\u65F6\u95F4\uFF5C\u9700\u5BC6\u94A5\u7684\u65F6\u533A\u53CA\u672C\u5730\u65F6\u95F4API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-7799561a688772cd01bea98c63d7cf91",
        "source_url": "https://timezonedb.com/references/get-time-zone",
        "content_sha256": "69b235507b8d16d2b96d039349ff639437b2fa916947649df9ecdef514d671b4",
        "decoded_bytes": 26777,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:37:19.5418592\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "69b235507b8d16d2b96d039349ff639437b2fa916947649df9ecdef514d671b4",
        "text_utf8_bytes": 26777,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-a7eb7f0e180bee1bb437e6f1/materials/material-7799561a688772cd01bea98c63d7cf91?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-8c2674e5acdf473692eb899e46e918f4",
    "reason": "\u6309\u672C\u6279TimeZoneDB\u5B98\u65B9get-time-zone\u53C2\u8003\u6574\u7406\u53C2\u6570\u3001\u54CD\u5E94\u3001Premium\u53CA\u8BB8\u53EF\uFF1B\u672A\u6CE8\u518C\u6216\u67E5\u8BE2IP/\u5750\u6807\u3002",
    "source_urls": [
      "https://timezonedb.com/references/get-time-zone"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-a7eb7f0e180bee1bb437e6f1",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-a7eb7f0e180bee1bb437e6f1?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-a7eb7f0e180bee1bb437e6f1?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure