Time zonesTime zonesReturns 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.
Use this 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.
Price: 0.003 USDC per call (x402, eip155:8453). Typical response time: 500 ms (p95).
POST https://x402-gateway.blackwoodstate8.workers.dev/v1/timezone. A request without payment gets 402 Payment Required with the
PAYMENT-REQUIRED header; any x402 client signs an EIP-3009 authorization and retries with
PAYMENT-SIGNATURE (or X-PAYMENT). Invalid input is answered with 400 and not charged.
curl -i -X POST https://x402-gateway.blackwoodstate8.workers.dev/v1/timezone -H 'content-type: application/json' -d '{"time":"2026-11-03T09:00","from":"America/New_York","to":["Europe/London","Asia/Tokyo","America/Sao_Paulo"]}'
| Pay to | 0xe9f11c62A66890a72AC21E35ee9b924324773Ad7 |
|---|---|
| Asset | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC) |
| Amount | 3000 atomic units (0.003 USDC) |
| Authorization window | 60 s |
Streamable HTTP at https://x402-gateway.blackwoodstate8.workers.dev/mcp, tool blackwood_timezone_convert. Payment goes in
_meta["x402/payment"]; without it the tool returns the payment requirements.
| Field | Type | Meaning |
|---|---|---|
time (optional) | string | 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 |
from (optional) | string | IANA time zone of a local time, e.g. America/Sao_Paulo (UTC when omitted) |
to | array | IANA time zones to convert to, e.g. ["Europe/London", "Asia/Tokyo"] |
Example:
{
"time": "2026-11-03T09:00",
"from": "America/New_York",
"to": [
"Europe/London",
"Asia/Tokyo",
"America/Sao_Paulo"
]
}
Real example:
{
"instant": "2026-11-03T14:00:00.000Z",
"epochMs": 1793714400000,
"from": {
"zone": "America/New_York",
"localTime": "2026-11-03T09:00:00",
"offset": "-05:00",
"offsetMinutes": -300,
"abbreviation": "EST",
"dst": false
},
"to": [
{
"zone": "Europe/London",
"localTime": "2026-11-03T14:00:00",
"offset": "+00:00",
"offsetMinutes": 0,
"abbreviation": "GMT",
"dst": false
},
{
"zone": "Asia/Tokyo",
"localTime": "2026-11-03T23:00:00",
"offset": "+09:00",
"offsetMinutes": 540,
"abbreviation": "GMT+9",
"dst": false
},
{
"zone": "America/Sao_Paulo",
"localTime": "2026-11-03T11:00:00",
"offset": "-03:00",
"offsetMinutes": -180,
"abbreviation": "GMT-3",
"dst": false
}
],
"source": "IANA Time Zone Database (public domain), via Intl in the Cloudflare Workers runtime"
}
{
"type": "object",
"properties": {
"instant": {
"type": "string"
},
"epochMs": {
"type": "number"
},
"from": {
"type": "object",
"properties": {
"zone": {
"type": "string"
},
"localTime": {
"type": "string"
},
"offset": {
"type": "string"
},
"offsetMinutes": {
"type": "number"
},
"abbreviation": {
"type": "string"
},
"dst": {
"type": "boolean"
}
},
"required": [
"zone",
"localTime",
"offset",
"offsetMinutes",
"abbreviation",
"dst"
],
"additionalProperties": false
},
"to": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zone": {
"type": "string"
},
"localTime": {
"type": "string"
},
"offset": {
"type": "string"
},
"offsetMinutes": {
"type": "number"
},
"abbreviation": {
"type": "string"
},
"dst": {
"type": "boolean"
}
},
"required": [
"zone",
"localTime",
"offset",
"offsetMinutes",
"abbreviation",
"dst"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
}
},
"required": [
"instant",
"epochMs",
"from",
"to",
"source"
],
"additionalProperties": false
}Free schema and example: GET https://x402-gateway.blackwoodstate8.workers.dev/v1/timezone.
OpenAPI 3.1 · llms.txt · All services