{"uid":"cap_misvsS8FncXPCdmqXUuCl","slug":"work-time-calc-working-hours-between-timestamps-2623d7ed","name":"Work Time Calc – Working Hours Between Timestamps","description":"Working hours between two timestamps under a weekly schedule with breaks and a holiday list.","url":"https://work-time-calc.x402tookit.com/working-hours?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["start","end","schedule"],"properties":{"end":{"type":"string","description":"Local end YYYY-MM-DDTHH:MM (no zone), not before start"},"start":{"type":"string","description":"Local start YYYY-MM-DDTHH:MM (no zone)"},"holidays":{"type":"string","description":"Comma-separated holiday dates YYYY-MM-DD (no working time)"},"schedule":{"type":"string","description":"Weekly windows, e.g. mon-fri 09:00-12:00 13:00-17:00; sat 09:00-13:00"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"clock":{"type":["null","string"]},"perDay":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":["null","string"]},"note":{"type":["null","string"]},"hours":{"type":["null","number"]},"weekday":{"type":["null","string"]}}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"workingHours":{"type":["null","number"]},"wallClockHours":{"type":["null","number"]},"workingMinutes":{"type":["null","number"]},"workingSeconds":{"type":["null","number"]},"perDayTruncated":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v2HOrvsn8_JJH02qvjbzM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the net working hours between two timestamps based on a custom weekly schedule with break windows and an optional holiday exclusion list.","exampleAgentPrompt":"How many working hours are there between 2024-06-03T09:00 and 2024-06-28T17:00, using a mon-fri 09:00-12:00 13:00-17:00 schedule, and excluding 2024-06-19 as a holiday?","exampleUseCases":[{"title":"Project deadline hours estimate","prompt":"How many actual working hours are between 2024-07-01T09:00 and 2024-07-31T17:00 on a mon-fri 09:00-17:00 schedule with a lunch break 12:00-13:00, excluding 2024-07-04?"},{"title":"Contractor billing hours calculation","prompt":"A contractor worked from 2024-05-13T08:00 to 2024-05-31T18:00 on a mon-fri 08:00-12:00 13:00-18:00 schedule. Can you calculate the total working hours excluding 2024-05-27?"},{"title":"SLA resolution time in business hours","prompt":"How many working hours elapsed between a ticket opened at 2024-08-12T14:30 and closed at 2024-08-15T11:00, using a mon-fri 09:00-17:00 schedule and no holidays?"}],"resultDescription":"Returns total working hours, minutes, and seconds within the specified range after filtering out non-scheduled time and holidays. Also includes wall clock hours, a per-day breakdown with date, weekday, hours worked, and any notes (e.g. holiday), plus a summary string, verdict, and optional degraded/disclaimer flags.","failureModes":["Missing required query params (start, end, schedule) returns an error","End timestamp before start timestamp returns a validation error","Malformed schedule string (wrong format) may return a degraded result or error","Invalid date formats in start/end or holidays list cause parsing failures","Very large date ranges may result in truncated per-day arrays (perDayTruncated=true)"],"whenToPreferThis":"Choose this endpoint when you need to compute net working time between two timestamps under a custom weekly schedule with optional break windows and holiday exclusions — especially for payroll, billing, SLA tracking, or project estimation use cases. Prefer it over simple date-diff tools when you need schedule-aware filtering (e.g. excluding lunch breaks, weekends, and public holidays).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:22.756Z","isFirstParty":false,"canonicalSlug":"work-time-calc-working-hours-between-timestamps-2623d7ed"}