# Timezone Converter (IANA / DST-Aware)

> Timezone Converter (IANA / DST-Aware) is a paid API for AI agents from x402-deployer.x402-deployer.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Converts a datetime from one IANA timezone to another, handling DST correctly and returning formatted strings, UTC offsets, and the hour difference.

## Facts

- Endpoint: POST https://x402-deployer.x402-deployer.workers.dev/timezone-convert
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-d52d5d79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OG6ZX8wC4DS2DYgkdxO6O

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 x402-deployer-x402-deployer-workers-dev-d52d5d79 -d '<json body>'
```

Example prompt: What time is the 9am meeting in America/New_York when converted to Asia/Tokyo on 2024-03-10, and how many hours apart are they?

## When to prefer this

Use this endpoint when you need accurate, DST-aware conversion between any two IANA timezone identifiers with full UTC offset metadata and hour-difference output — especially for scheduling across cities or normalizing datetimes for logs and APIs.

## Known failure modes

- Invalid or unrecognized IANA timezone name — returns error indicating unknown timezone
- Malformed ISO-8601 datetime string — parse error returned
- Missing required fields (datetime, from_tz, or to_tz) — validation error
- Payment not included or insufficient — x402 payment required error

## How this service works

Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities. Convert a datetime from one IANA timezone to another. ISO-8601 input — bare wall-time strings are interpreted in the from_tz, fully-qualified offsets are honored. DST is handled correctly (uses V8's built-in tzdata via Intl.DateTimeFormat). Returns both formatted strings, both UTC offsets, and the difference in hours.

## Output

Returns the original and converted datetime as formatted strings, the UTC offset for both the source and target timezone (accounting for DST), and the numeric hour difference between the two timezones.

## Example request

```json
{
 "to_tz": "Asia/Tokyo",
 "from_tz": "America/New_York",
 "datetime": "2024-03-10T09:00:00"
}
```

## 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": {
     "required": [
      "datetime",
      "from_tz",
      "to_tz"
     ],
     "properties": {
      "to_tz": {
       "type": "string",
       "description": "IANA timezone for the output (e.g. 'Asia/Tokyo')."
      },
      "from_tz": {
       "type": "string",
       "description": "IANA timezone for the input wall-time (e.g. 'America/Los_Angeles')."
      },
      "datetime": {
       "type": "string",
       "description": "ISO-8601 datetime. With offset (e.g. '2026-05-08T12:00:00-07:00') it's used as-is; without offset (e.g. '2026-05-08T12:00:00') it's interpreted in from_tz."
      }
     }
    },
    "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",
     "properties": {
      "to": {
       "type": "object",
       "properties": {
        "tz": {
         "type": "string"
        },
        "datetime": {
         "type": "string"
        },
        "utc_offset_minutes": {
         "type": "integer"
        }
       }
      },
      "from": {
       "type": "object",
       "properties": {
        "tz": {
         "type": "string"
        },
        "datetime": {
         "type": "string"
        },
        "utc_offset_minutes": {
         "type": "integer"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "utc_iso": {
       "type": "string"
      },
      "utc_offset_diff_hours": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-d52d5d79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-deployer.x402-deployer.workers.dev](https://www.zero.xyz/host/x402-deployer.x402-deployer.workers.dev/llms.txt)