# Date Math: Working Hours Overlap Finder

> Date Math: Working Hours Overlap Finder 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-21).

Finds time windows when working hours overlap across multiple time zones, skipping weekends by default, over up to 14 days.

## Facts

- Endpoint: POST https://date-math.datemath.workers.dev/v1/overlap?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/date-math-working-hours-overlap-finder-928030fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lXe1ZC2_Ec63e9qTWqulu

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-working-hours-overlap-finder-928030fa -d '<json body>'
```

Example prompt: Find all overlapping working hours between someone in New York (9am–5pm) and someone in Manila (9am–6pm) for the next 3 business days starting Monday November 10, 2025, skipping weekends.

## When to prefer this

Use this endpoint when you need to find specific calendar windows where multiple participants in different time zones are simultaneously within their working hours. It is ideal for scheduling meetings or standups across geographically distributed teams, especially when participants have non-standard hours. It natively handles DST transitions via IANA zone data and skips weekends automatically. Prefer this over generic timezone conversion endpoints when you need intersection logic rather than a simple offset calculation.

## Known failure modes

- Fewer than 2 time zones provided — API requires minItems:2
- Invalid IANA time zone string — returns error or empty result
- No overlap exists in the search window — returns empty windows array
- days exceeds 14 — schema maximum enforced
- Invalid time format for work_start or work_end — pattern validation fails
- date string in wrong format — must be YYYY-MM-DD

## How this service works

Date Math: Find when working hours overlap across time zones: the best meeting times for a distributed or remote team. Per-participant hours optional; skips weekends by default; up to 14 days.

## Output

Returns an array of overlap windows for each day searched, each window including UTC start/end times, duration in minutes, and the local start/end times for each participant in their own time zone. Also returns total overlap minutes across all windows, participant details, and the reference timezone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD in the first participant's zone; defaults to today"
  },
  "days": {
   "type": "integer",
   "maximum": 14,
   "minimum": 1,
   "description": "Number of days to search (default 1)"
  },
  "work_end": {
   "type": "string",
   "example": "17:00",
   "pattern": "^([01]\\d|2[0-4]):[0-5]\\d$"
  },
  "timezones": {
   "type": "array",
   "items": {
    "type": "string",
    "description": "IANA time zone, e.g. Asia/Manila"
   },
   "maxItems": 10,
   "minItems": 2
  },
  "work_start": {
   "type": "string",
   "example": "09:00",
   "pattern": "^([01]\\d|2[0-4]):[0-5]\\d$"
  },
  "participants": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "timezone"
    ],
    "properties": {
     "timezone": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Manila"
     },
     "work_end": {
      "type": "string",
      "example": "09:00",
      "pattern": "^([01]\\d|2[0-4]):[0-5]\\d$"
     },
     "work_start": {
      "type": "string",
      "example": "09:00",
      "pattern": "^([01]\\d|2[0-4]):[0-5]\\d$"
     }
    }
   },
   "maxItems": 10,
   "minItems": 2
  },
  "skip_weekends": {
   "type": "boolean",
   "description": "Default true"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-11-11T00:00:00+08:00",
  "from": "2026-11-10T00:00:00+08:00",
  "windows": [
   {
    "local": [
     {
      "end": "2026-11-10T18:00:00+08:00",
      "start": "2026-11-10T17:00:00+08:00",
      "timezone": "Asia/Manila"
     }
    ],
    "end_utc": "2026-11-10T10:00:00Z",
    "start_utc": "2026-11-10T09:00:00Z",
    "duration_minutes": 60
   }
  ],
  "participants": [
   {
    "timezone": "Asia/Manila",
    "work_end": "18:00",
    "work_start": "09:00"
   }
  ],
  "reference_timezone": "Asia/Manila",
  "total_overlap_minutes": 60
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/date-math-working-hours-overlap-finder-928030fa/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)
