{"uid":"cap_lXe1ZC2_Ec63e9qTWqulu","slug":"date-math-working-hours-overlap-finder-928030fa","name":"Date Math: Working Hours Overlap Finder","description":"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.","url":"https://date-math.datemath.workers.dev/v1/overlap?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TJoXXh7_yWThrfPOR4o51","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds time windows when working hours overlap across multiple time zones, skipping weekends by default, over up to 14 days.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Global team standup scheduling","prompt":"I need to find windows when my team in London (9am–5pm), New York (9am–5pm), and Singapore (9am–6pm) can all meet next week — search the 5 days starting Monday December 1, 2025 and skip weekends."},{"title":"US–India client call slot","prompt":"What times overlap between a client in Chicago (9am–5pm) and our developer in Bangalore (10am–7pm) this Friday December 5, 2025? Just search that one day."},{"title":"Cross-timezone contractor overlap check","prompt":"I'm hiring contractors in Berlin and São Paulo with custom hours — Berlin 8am to 4pm and São Paulo 10am to 6pm. Can you check what overlap exists over the next 7 days starting today, skipping weekends?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:35:35.622Z","isFirstParty":false,"canonicalSlug":"date-math-working-hours-overlap-finder-928030fa"}