# Timezone Overlap Hours Calculator

> Timezone Overlap Hours Calculator 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-18).

Calculates working-hours overlap across 2–10 IANA time zones on a given date, returning per-zone UTC offsets, abbreviations, DST flags, and the overlapping window (if any).

## Facts

- Endpoint: POST https://timezone-convert.x402supply.com/tools/overlap_hours?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/timezone-overlap-hours-calculator-0b263697
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R99iVZY6MqUo8kpwvVBob

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-overlap-hours-calculator-0b263697 -d '<json body>'
```

Example prompt: Can you find the overlap in working hours (9am–5pm) between America/New_York, Europe/London, and Asia/Kolkata on 2026-10-09? I want to know if there's any window where all three teams can meet.

## When to prefer this

Choose this endpoint when you need to compute the actual overlapping working-hours window across multiple IANA time zones on a specific calendar date, especially when DST correctness matters. Prefer it over manual UTC offset arithmetic or generic timezone converters when you need a structured, machine-readable overlap result with DST flags and per-zone UTC-stamped work windows.

## Known failure modes

- Invalid IANA zone name returns an error or warning
- Fewer than 2 or more than 10 zones causes validation failure
- Date not in YYYY-MM-DD format rejected by pattern validation
- workEnd before or equal to workStart causes an error
- No overlap exists — returns hasOverlap: false with overlapMinutes: 0 and null overlap fields
- DST transition edge cases flagged in warnings array but still processed

## 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.; Returns a zone&#39;s current UTC offset and abbreviation, whether it observes DST, standard and DST o

## Output

A JSON object containing: per-zone breakdown of work window in local and UTC time, UTC offset, DST flag, and timezone abbreviation; a top-level overlap object with overlapStart/overlapEnd in UTC and local time per zone; overlapMinutes integer; hasOverlap boolean; and a warnings array flagging DST transitions or ambiguous times.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "maxLength": 10,
   "minLength": 10,
   "description": "Calendar date YYYY-MM-DD, evaluated as that date in each zone"
  },
  "zones": {
   "type": "string",
   "maxLength": 700,
   "minLength": 3,
   "description": "Comma-separated IANA zones, 2-10, e.g. America/New_York,Europe/London"
  },
  "workEnd": {
   "type": "string",
   "default": "17:00",
   "pattern": "^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$",
   "description": "Working day end HH:mm, default 17:00. Must be after workStart"
  },
  "workStart": {
   "type": "string",
   "default": "09:00",
   "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
   "description": "Working day start HH:mm, default 09:00"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-09",
  "zones": [
   {
    "zone": "America/New_York",
    "isDst": true,
    "workEnd": "2026-10-09T17:00:00-04:00",
    "utcOffset": "-04:00",
    "workStart": "2026-10-09T09:00:00-04:00",
    "overlapEnd": null,
    "workEndUtc": "2026-10-09T21:00:00.000Z",
    "abbreviation": "EDT",
    "overlapStart": null,
    "workStartUtc": "2026-10-09T13:00:00.000Z"
   },
   {
    "zone": "Europe/London",
    "isDst": true,
    "workEnd": "2026-10-09T17:00:00+01:00",
    "utcOffset": "+01:00",
    "workStart": "2026-10-09T09:00:00+01:00",
    "overlapEnd": null,
    "workEndUtc": "2026-10-09T16:00:00.000Z",
    "abbreviation": "BST",
    "overlapStart": null,
    "workStartUtc": "2026-10-09T08:00:00.000Z"
   },
   {
    "zone": "Asia/Kolkata",
    "isDst": false,
    "workEnd": "2026-10-09T17:00:00+05:30",
    "utcOffset": "+05:30",
    "workStart": "2026-10-09T09:00:00+05:30",
    "overlapEnd": null,
    "workEndUtc": "2026-10-09T11:30:00.000Z",
    "abbreviation": "IST",
    "overlapStart": null,
    "workStartUtc": "2026-10-09T03:30:00.000Z"
   }
  ],
  "source": [
   "https://www.iana.org/time-zones"
  ],
  "overlap": null,
  "workEnd": "17:00",
  "warnings": [],
  "workStart": "09:00",
  "hasOverlap": false,
  "overlapMinutes": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/timezone-overlap-hours-calculator-0b263697/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)