# Timezone Conversion API (x402-gateway.blackwoodstate8.workers.dev) > Timezone Conversion API (x402-gateway.blackwoodstate8.workers.dev) is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-23). Converts a date/time between IANA time zones with daylight saving rules, returning UTC offsets, abbreviations, and current local times. ## Facts - Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/timezone?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-23 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/timezone-conversion-api-x402-gateway-blackwoodstate8-workers-dev-63208b6c - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Hg6vbxqMPWCaeMRQPyjK Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability timezone-conversion-api-x402-gateway-blackwoodstate8-workers-dev-63208b6c -d '' ``` Example prompt: What time is it right now in Europe/London and Asia/Tokyo, and are either of them currently observing daylight saving time? ## When to prefer this Use this endpoint when you have exact IANA time zone names (e.g. America/New_York, Europe/London) and need accurate DST-aware conversion or the current local time in one or more zones. Prefer this over generic datetime libraries when you need authoritative IANA tz database results via a simple API call, especially when handling multiple target zones in one request. Do not use for lookups by city name, street address, or coordinates — those require a separate geocoding-to-timezone step first. ## Known failure modes - Unknown or misspelled IANA zone name returns an error — city names or addresses without an IANA zone identifier are not supported - Dates before 1970 (epoch 0) are not supported and may return an error or undefined behavior - Malformed ISO 8601 datetime string causes a validation error - Missing required 'to' field causes a schema validation error - Network or worker timeout may occur occasionally beyond the 500ms p95 baseline ## How this service works Use when you need timezone conversion between time zones, the current time in a zone or a utc offset with daylight saving. Do not use for places given only by city or address without an IANA zone name, or dates before 1970. Returns JSON converting a date and time between IANA time zones with daylight saving rules, with UTC offsets, abbreviations and the current time in each zone, from the IANA tz database for 0.003 USDC per call. Typical response time 500 ms (p95). Category: Data. ## Output Returns a JSON object with the resolved instant (ISO 8601 and epoch milliseconds), the 'from' zone details (local time, UTC offset string, offset in minutes, abbreviation, DST flag), and an array of 'to' zone entries each containing the same fields. Covers all IANA tz database zones with current DST rules. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method", "bodyType", "body" ], "properties": { "body": { "type": "object", "required": [ "to" ], "properties": { "to": { "type": "array", "items": { "type": "string", "maxLength": 64, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "IANA time zones to convert to, e.g. [\"Europe/London\", \"Asia/Tokyo\"]" }, "from": { "type": "string", "maxLength": 64, "minLength": 1, "description": "IANA time zone of a local time, e.g. America/Sao_Paulo (UTC when omitted)" }, "time": { "type": "string", "maxLength": 40, "description": "Date and time to convert, ISO 8601: local wall time like 2026-10-17T15:30 (read in the from zone) or an instant with Z or an offset; now when omitted" } } }, "type": { "type": "string", "const": "http" }, "method": { "enum": [ "POST" ], "type": "string" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "instant", "epochMs", "from", "to", "source" ], "properties": { "to": { "type": "array", "items": { "type": "object", "required": [ "zone", "localTime", "offset", "offsetMinutes", "abbreviation", "dst" ], "properties": { "dst": { "type": "boolean" }, "zone": { "type": "string" }, "offset": { "type": "string" }, "localTime": { "type": "string" }, "abbreviation": { "type": "string" }, "offsetMinutes": { "type": "number" } }, "additionalProperties": false } }, "from": { "type": "object", "required": [ "zone", "localTime", … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "to": [ { "dst": false, "zone": "Europe/London", "offset": "+00:00", "localTime": "2026-11-03T14:00:00", "abbreviation": "GMT", "offsetMinutes": 0 }, { "dst": false, "zone": "Asia/Tokyo", "offset": "+09:00", "localTime": "2026-11-03T23:00:00", "abbreviation": "GMT+9", "offsetMinutes": 540 }, { "dst": false, "zone": "America/Sao_Paulo", "offset": "-03:00", "localTime": "2026-11-03T11:00:00", "abbreviation": "GMT-3", "offsetMinutes": -180 } ], "from": { "dst": false, "zone": "America/New_York", "offset": "-05:00", "localTime": "2026-11-03T09:00:00", "abbreviation": "EST", "offsetMinutes": -300 }, "source": "IANA Time Zone Database (public domain), via Intl in the Cloudflare Workers runtime", "epochMs": 1793714400000, "instant": "2026-11-03T14:00:00.000Z" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/timezone-conversion-api-x402-gateway-blackwoodstate8-workers-dev-63208b6c/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)