{"id":"working-hours-total","version":"1.0.0","description":"Total exact elapsed seconds in a versioned working-hours calendar after DST and closure expansion.","supported_operations":["total working hours in date range","sum shift duration exactly","calculate elapsed office seconds","total split-shift time","DST-aware working time total","sum schedule after closures","total overridden work hours"],"unsupported_operations":["calculate payroll or wages","round billable time","infer public holidays"],"semantics":["Totals the union of exact UTC half-open intervals, so repeated-hour alternatives are never double-counted.","Expansion follows RFC 9557 and ISO 8601-1:2019 under explicit DST policies.","Pinned IANA tzdb 2025b subset only; caller_rule_version is echoed without asserting legal currency."],"limits":{"max_input_bytes":200000,"max_days":366,"max_intervals_per_day":16,"max_overrides":366,"max_closures":366,"max_output_intervals":12000},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["calendar","range_start_date","range_end_date"],"properties":{"calendar":{"type":"object","additionalProperties":false,"required":["time_zone","caller_rule_version","weekly","overrides","closures","gap_policy","overlap_policy"],"properties":{"time_zone":{"type":"string","minLength":1,"maxLength":64},"caller_rule_version":{"type":"string","minLength":1,"maxLength":100},"weekly":{"type":"object","additionalProperties":false,"properties":{"sun":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"mon":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"tue":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"wed":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"thu":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"fri":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"sat":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}}}},"overrides":{"type":"array","maxItems":366,"items":{"type":"object","additionalProperties":false,"required":["date","intervals"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"intervals":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}}}}},"closures":{"type":"array","maxItems":366,"uniqueItems":true,"items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"gap_policy":{"type":"string","enum":["reject","shift_forward"]},"overlap_policy":{"type":"string","enum":["earlier","later","both"]}}},"range_start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"range_end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"output_schema":{"type":"object","additionalProperties":false,"required":["standard_version","data_version","caller_rule_version","canonical_time_zone","total_seconds","interval_count"],"properties":{"standard_version":{"type":"string"},"data_version":{"type":"string"},"caller_rule_version":{"type":"string"},"canonical_time_zone":{"type":"string"},"total_seconds":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"interval_count":{"type":"integer","minimum":0,"maximum":12000}}},"examples":[{"input":{"calendar":{"time_zone":"UTC","caller_rule_version":"example-v1","weekly":{"mon":[{"start":"09:00","end":"12:00"},{"start":"13:00","end":"17:00"}]},"overrides":[],"closures":[],"gap_policy":"reject","overlap_policy":"earlier"},"range_start_date":"2025-01-06","range_end_date":"2025-01-07"},"output":{"standard_version":"RFC 9557; ISO 8601-1:2019","data_version":"iana-tzdb-2025b","caller_rule_version":"example-v1","canonical_time_zone":"UTC","total_seconds":"25200","interval_count":2}},{"input":{"calendar":{"time_zone":"UTC","caller_rule_version":"example-v1","weekly":{"mon":[{"start":"09:00","end":"12:00"},{"start":"13:00","end":"17:00"}]},"overrides":[],"closures":["2025-01-06"],"gap_policy":"reject","overlap_policy":"earlier"},"range_start_date":"2025-01-06","range_end_date":"2025-01-07"},"output":{"standard_version":"RFC 9557; ISO 8601-1:2019","data_version":"iana-tzdb-2025b","caller_rule_version":"example-v1","canonical_time_zone":"UTC","total_seconds":"0","interval_count":0}}],"execute_url":"/v1/tools/working-hours-total/versions/1.0.0/execute"}