Hours Calculator

Hours Calculator

Pure time arithmetic for duration between two clock times and paid work hours across one or more shifts (with breaks and optional daily grouping).

Capabilities

• Duration between times: Supply start and end in 24-hour HH:MM or HH:MM:SS. Get hours, minutes, seconds, and totals as decimal hours, decimal minutes, and whole seconds, plus a readable phrase. If end is earlier on the clock than start, either pass overnight=true (treats end as the next day) or the tool returns an error that points you to that flag.
• Work hours from shifts: Each shift has clock_in, clock_out, optional break_minutes (default 0), and optional date (YYYY-MM-DD). If clock_out is earlier on the clock than clock_in, the block is treated as an overnight shift. Returns a per-shift breakdown, total paid hours/minutes/seconds, regular_hours and overtime_hours against overtime_threshold (default 40 total hours for the whole request), and daily_totals_hours when dates are present.

Gotchas

• 24-hour times only; invalid strings are rejected with a short explanation.
• Overtime is computed from the sum of all shifts in the call versus overtime_threshold, not per calendar week unless your caller only sends one week’s shifts.
• break_minutes cannot exceed the gross span from clock-in to clock-out (before the break).