Work Hours & Time Card Calculator

A work-hours calculator turns clock-in and clock-out entries into a time card without requiring an account, employee database, or full scheduling platform. This one is designed for the common independent task: record one or more shifts on each weekday, describe paid and unpaid breaks, and see daily and weekly totals in both hours-and-minutes and decimal hours. It works for an hourly worker checking a time card, a freelancer preparing an invoice, a manager reviewing a draft schedule, a contractor documenting site hours, or a student balancing work and study blocks.

The calculator treats time as whole minutes. A 9:00 AM clock-in and 5:30 PM clock-out create 510 gross minutes. A 30-minute unpaid lunch reduces that to 480 worked minutes, displayed as 8:00 and 8.00 decimal hours. A paid break is reported separately but remains inside worked time. That distinction is important: the tool never hides whether a break was deducted.

Overnight shifts use a clear rule. If clock-out is earlier than clock-in, clock-out is treated as occurring on the following day. A shift from 10:00 PM to 6:30 AM therefore lasts 8 hours 30 minutes. After a 30-minute unpaid break, net worked time is 8 hours. The entire shift belongs to the weekday on which it started, preventing the same minutes from being added to two days. Because the interface uses wall-clock times rather than timezone-aware attendance records, daylight-saving transitions require manual review.

Each day can contain multiple shifts, which supports split schedules such as 8:00 AM–12:00 PM and 2:00 PM–6:00 PM. The calculator checks those shifts on a shared timeline. If one overlaps another, the weekly total is blocked until the conflict is corrected instead of silently counting the same minutes twice. Timed breaks are also checked for overlap and must stay within their shift. Duration-only breaks are useful when exact lunch timestamps are not available.

Weekly totals include gross scheduled time, paid breaks, unpaid breaks, net worked time, shift count, and overnight-shift count. Optional overtime settings divide net minutes into regular and overtime portions using thresholds chosen by the user. Daily, weekly, both, or disabled modes are available. These are arithmetic labels only. The calculator does not infer a country, state, contract, employer policy, or legally required overtime rule, and it does not estimate wages.

Rounding is similarly explicit. Users may leave times unrounded or choose 5-, 6-, 10-, or 15-minute intervals, then round to the nearest interval, always up, or always down. Rounding can apply to clock-in and clock-out, the final shift total, or both. When a result changes, the original and rounded totals appear together. No rounding happens silently, and users should confirm whether any rounding method is permitted for their records.

Recurring schedules can be saved as local templates. A template contains days, shifts, breaks, overtime settings, time display, and rounding preferences, but it does not require an employee name. Templates can be applied, renamed, duplicated, deleted, or cleared. Browser storage is device- and profile-specific, so clearing site data removes them. CSV and print output are generated locally. Share links encode the current time-card structure and settings but deliberately remove notes and do not include names, emails, employer details, or payroll identifiers.

Clock arithmetic in whole minutes

Each clock value is converted to minutes after midnight: 9:15 AM becomes 555 and 5:30 PM becomes 1,050. When clock-out is numerically earlier than clock-in, 1,440 minutes are added to clock-out. Gross duration is adjusted clock-out minus clock-in. Equal start and end times are rejected rather than assumed to mean a 24-hour shift.

Break treatment

Duration-only breaks contribute the entered number of minutes. Timed breaks are placed on the same shift timeline, including across midnight, checked against shift boundaries, and compared with other timed breaks for overlap. Paid and unpaid totals are accumulated independently. Net worked time equals gross time minus unpaid breaks; paid breaks remain in net worked time.

Daily and weekly totals

Valid shift results are summed as integers. Overlapping shifts cause a day error and block the weekly result. Daily overtime, when enabled, is the portion of each day above the chosen threshold. In combined mode, daily overtime is separated first; the weekly threshold then applies to the remaining regular minutes, avoiding double classification.

Decimal conversion and rounding

Decimal hours are produced only for display or export by dividing total minutes by 60 and rounding to two decimal places. Rounding uses the chosen interval and direction. Time rounding changes clock boundaries; total rounding changes the final shift duration. Selecting both applies those operations in that order.

The calculator accepts wall-clock times and does not attach a timezone or calendar date to each shift. It therefore cannot automatically resolve daylight-saving changes, historical timezone rules, leap seconds, or employer-specific punch corrections. A shift must be under 24 hours and equal clock times are treated as invalid, not a full day. Duration-only breaks cannot be checked for timestamp overlap because they have no position inside the shift; use timed breaks when that validation matters.

Overtime output is a user-defined arithmetic split, not a legal entitlement or payroll rule. The tool does not calculate pay, overtime multipliers, taxes, deductions, benefits, leave, premiums, rounding compliance, or multi-week overtime. Share links can become long for unusually dense schedules and are capped for practicality. Browser-local templates do not synchronize between devices.

The client-side engine is a standalone ES module. Time parsing normalizes 12-hour or 24-hour strings to integers from 0 through 1,439. Overnight end times receive a 1,440-minute offset. Shift, timed-break, and same-day shift intervals are compared numerically; conflicts throw descriptive validation errors. Week aggregation never sums formatted strings or decimal-hour values.

Shared state uses versioned JSON encoded as URL-safe Base64. A sanitizer caps days, shifts, breaks, note length, settings, and accepted enum values. Notes are removed before encoding, malformed state returns null, and oversized links are rejected. Templates pass through the same week sanitizer and corrupted JSON returns an empty list.

CSV generation performs standard quote doubling and wraps cells containing commas, quotes, carriage returns, or newlines. The browser prepends a UTF-8 byte-order mark for spreadsheet compatibility. Print output is rendered into a dedicated body-level root because the project isolates printable documents from application navigation.

A work-hours calculator is narrower than workforce-management or payroll software. It is faster for an independent check and keeps data local, but it does not approve punches, schedule employees, synchronize devices, calculate wages, retain audit logs, or enforce policy. HH:MM is best for human reading; decimal hours are useful for multiplication and spreadsheets. A template is a reusable input pattern, not proof that a shift occurred.

Hourly workers checking daily or weekly totals, freelancers converting time to invoice-ready decimal hours, contractors documenting shifts, managers reviewing draft schedules without uploading employee data, students tracking work or study blocks, and small teams that need a quick time-card calculation rather than a full tracking platform. Anyone making payroll, legal, tax, or compliance decisions should use an authoritative record and qualified guidance in addition to this arithmetic tool.