# timezone-convert.x402supply.com Time Zone Converter

> timezone-convert.x402supply.com Time Zone Converter is a paid API for AI agents from timezone-convert.x402supply.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-17).

Converts a local time from one IANA time zone to up to 20 target IANA time zones, returning local time, UTC offset, abbreviation, DST flag, and handling DST edge cases.

## Facts

- Endpoint: POST https://timezone-convert.x402supply.com/tools/convert_time?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/timezone-convert-x402supply-com-time-zone-converter-b646e56f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xgICkmRQkaXkSTQUWEe0J

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-convert-x402supply-com-time-zone-converter-b646e56f -d '<json body>'
```

Example prompt: Convert 2026-03-08T02:30:00 in America/New_York to Europe/London, Asia/Kolkata, and Asia/Tokyo — and let me know if the source time is ambiguous or nonexistent due to DST.

## When to prefer this

Choose this endpoint when you need accurate, DST-aware conversion of a single datetime across multiple IANA time zones in one call, especially when handling tricky DST transition edge cases like spring-forward gaps or fall-back overlaps. It is ideal for scheduling agents coordinating across international teams, event localization pipelines, or any workflow requiring precise UTC offset and abbreviation data per zone. Prefer it over generic time APIs when you need up to 20 simultaneous zone conversions with nonexistent and ambiguous time detection built in.

## Known failure modes

- Invalid or unrecognized IANA zone string returns an error for that zone
- More than 20 target zones specified causes a validation error
- Malformed datetime string (not ISO 8601 or YYYY-MM-DD HH:mm) returns a parse error
- Missing required fields (time or from) returns a 400-level error
- Network or payment authorization failure returns a 402 or 5xx error

## How this service works

Converts a local time in one IANA zone to up to 20 target zones. Returns local time, UTC offset, abbreviation and DST flag per target, and flags nonexistent or ambiguous local times at DST transitions.

## Output

For each target IANA time zone, the endpoint returns the converted local time, its UTC offset, the timezone abbreviation (e.g. EST, IST), and a boolean DST flag. It also flags whether the original source time is nonexistent (falls in a spring-forward gap) or ambiguous (falls in a fall-back overlap), with control over which occurrence to use in the ambiguous case.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "maxLength": 1500,
   "minLength": 1,
   "description": "Comma-separated target IANA zones, 1-20, e.g. Europe/London,Asia/Kolkata"
  },
  "from": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1,
   "description": "Source IANA zone, e.g. America/New_York"
  },
  "time": {
   "type": "string",
   "maxLength": 40,
   "minLength": 10,
   "description": "ISO 8601 (2026-03-08T02:30:00, optional Z or offset) or 'YYYY-MM-DD HH:mm'. Without an offset it is read as local time in `from`"
  },
  "ambiguous": {
   "enum": [
    "earlier",
    "later"
   ],
   "type": "string",
   "default": "earlier",
   "description": "Which occurrence to use when the local time happens twice (fall-back). Default earlier (first, DST side)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "from": {
   "zone": "America/New_York",
   "isDst": true,
   "status": "nonexistent",
   "localTime": "2026-03-08T03:30:00-04:00",
   "utcOffset": "-04:00",
   "adjustment": "shifted_forward_by_gap",
   "gapMinutes": 60,
   "abbreviation": "EDT",
   "offsetMinutes": -240,
   "requestedLocalTime": "2026-03-08 02:30"
  },
  "input": "2026-03-08 02:30",
  "source": [
   "https://www.iana.org/time-zones"
  ],
  "instant": "2026-03-08T07:30:00.000Z",
  "warnings": [
   "2026-03-08 02:30 does not exist in America/New_York: clocks skip forward 60 minutes at this time. Interpreted as the same wall time shifted forward by the gap (2026-03-08T03:30:00-04:00)."
  ],
  "conversions": [
   {
    "zone": "UTC",
    "isDst": false,
    "dayOffset": 0,
    "localTime": "2026-03-08T07:30:00+00:00",
    "utcOffset": "+00:00",
    "abbreviation": "UTC",
    "offsetMinutes": 0,
    "ambiguousLocalTime": false
   },
   {
    "zone": "Europe/London",
    "isDst": false,
    "dayOffset": 0,
    "localTime": "2026-03-08T07:30:00+00:00",
    "utcOffset": "+00:00",
    "abbreviation": "GMT",
    "offsetMinutes": 0,
    "ambiguousLocalTime": false
   },
   {
    "zone": "Asia/Kolkata",
    "isDst": false,
    "dayOffset": 0,
    "localTime": "2026-03-08T13:00:00+05:30",
    "utcOffset": "+05:30",
    "abbreviation": "IST",
    "offsetMinutes": 330,
    "ambiguousLocalTime": false
   },
   {
    "zone": "Australia/Sydney",
    "isDst": true,
    "dayOffset": 0,
    "localTime": "2026-03-08T18:30:00+11:00",
    "utcOffset": "+11:00",
    "abbreviation": "AEDT",
    "offsetMinutes": 660,
    "ambiguousLocalTime": false
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/timezone-convert-x402supply-com-time-zone-converter-b646e56f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from timezone-convert.x402supply.com](https://www.zero.xyz/host/timezone-convert.x402supply.com/llms.txt)