# Timezone Converter with DST Handling

> Timezone Converter with DST Handling is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

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

## Facts

- Endpoint: POST https://x402.agentutility.ai/timezone-convert?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/timezone-converter-with-dst-handling-1d6f9d81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nqVRVDutZfHEy3w_09tKz

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-converter-with-dst-handling-1d6f9d81 -d '<json body>'
```

Example prompt: What time is it in Tokyo when it's 12:00 PM on May 8, 2026 in Los Angeles? Make sure daylight saving time is handled correctly.

## When to prefer this

Choose this endpoint when you need programmatically reliable, DST-aware timezone conversion using IANA timezone identifiers — especially for scheduling across cities or converting wall-clock times to UTC. Prefer this over client-side JS hacks or libraries that may have stale tzdata, and when you need structured JSON output with both offsets and the hour difference explicitly returned.

## Known failure modes

- Invalid IANA timezone name returns an error (e.g. 'America/NewYork' instead of 'America/New_York')
- Malformed ISO-8601 datetime string causes a parse error
- Payment failure via x402 protocol prevents the call from completing
- Ambiguous wall-clock times during DST transitions (e.g. clocks falling back) may resolve to one interpretation

## How this service works

Converts a datetime from one IANA timezone to another with correct DST handling. 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. Use it for DST-aware time arithmetic, wall-clock to UTC conversion, or converting across cities.

## Output

Returns a JSON object with: the original datetime and UTC offset for the source timezone, the converted datetime and UTC offset for the target timezone, the raw UTC ISO timestamp, the offset difference in hours, and the data source (IANA tzdata via Intl.DateTimeFormat).

## 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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": {
   "tz": "Asia/Tokyo",
   "datetime": "2026-05-09T04:00:00+09:00",
   "utc_offset_minutes": 540
  },
  "from": {
   "tz": "America/Los_Angeles",
   "datetime": "2026-05-08T12:00:00-07:00",
   "utc_offset_minutes": -420
  },
  "source": "Intl.DateTimeFormat (built-in, IANA tzdata)",
  "utc_iso": "2026-05-08T19:00:00.000Z",
  "utc_offset_diff_hours": 16
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/timezone-converter-with-dst-handling-1d6f9d81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)