# Date Math: Timezone Converter

> Date Math: Timezone Converter is a paid API for AI agents from date-math.datemath.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-17).

Converts an instant or local wall-clock datetime from one IANA time zone to another, fully DST-aware, returning structured date/time fields for both the source and destination zones.

## Facts

- Endpoint: POST https://date-math.datemath.workers.dev/v1/convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/date-math-timezone-converter-dc0ab97a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1kPvaob916P5E4YNY8n9r

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 date-math-timezone-converter-dc0ab97a -d '<json body>'
```

Example prompt: What time will it be in New York when it's 2:30pm on November 7, 2026 in Manila? Give me the full date and UTC offset too.

## When to prefer this

Use this endpoint when you need a DST-aware, authoritative timezone conversion that returns structured fields (date, time, weekday, UTC offset) for both source and destination zones, plus the UTC equivalent and Unix timestamp. Prefer it over generic date libraries when you need reliable IANA timezone handling including DST transitions, or when you need the result broken into discrete components rather than just an offset-adjusted string.

## Known failure modes

- Invalid or unrecognized IANA timezone name returns an error — must use valid IANA identifiers like 'America/New_York', not abbreviations like 'EST'
- Ambiguous local time during DST 'fall back' (e.g. 1:30am repeated) may resolve to one of two possible instants
- Missing from_timezone when a local (no-offset) datetime is provided will cause a parsing error
- Malformed datetime string not matching ISO 8601 or 'YYYY-MM-DDTHH:MM' will return an error
- Network or worker timeout under high load

## How this service works

Date Math: Convert a time between time zones (IANA names like Asia/Manila, America/New_York), DST-aware. Use for "what time is 3pm Manila in New York", scheduling across zones and UTC offsets.

## Output

A JSON object with 'from', 'to', and 'utc' blocks. Each block contains the date, time, weekday, full ISO 8601 datetime with UTC offset, timezone name, and UTC offset string. Also includes a 'unix_seconds' field for the instant.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "datetime": {
   "type": "string",
   "description": "ISO 8601 with offset, local YYYY-MM-DDTHH:MM[:SS] (needs from_timezone), or \"now\" (default)"
  },
  "to_timezone": {
   "type": "string",
   "example": "America/New_York"
  },
  "from_timezone": {
   "type": "string",
   "example": "Asia/Manila"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": {
   "date": "2026-11-07",
   "time": "01:30:00",
   "weekday": "Saturday",
   "datetime": "2026-11-07T01:30:00-05:00",
   "timezone": "America/New_York",
   "utc_offset": "-05:00"
  },
  "utc": "2026-11-07T06:30:00Z",
  "from": {
   "date": "2026-11-07",
   "time": "14:30:00",
   "weekday": "Saturday",
   "datetime": "2026-11-07T14:30:00+08:00",
   "timezone": "Asia/Manila",
   "utc_offset": "+08:00"
  },
  "unix_seconds": 1794033000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/date-math-timezone-converter-dc0ab97a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from date-math.datemath.workers.dev](https://www.zero.xyz/host/date-math.datemath.workers.dev/llms.txt)
