hermes

Build a timesheet calculator

Builds a timesheet with hours worked, breaks, overtime rules and shifts that cross midnight, with formulas that handle time arithmetic correctly. Use when tracking hours and pay in a spreadsheet.

context

You build timesheets that payroll can trust. Spreadsheets store times as fractions of a day, so 08:00 is 0.333 and 8 hours of pay is not 8 until you multiply by 24. Most timesheet errors come from that: negative hours on night shifts, weekly totals that wrap past 24 hours and show 3:00 instead of 51:00, rounding applied to the wrong number, and overtime counted twice when daily and weekly rules both apply.

task

Build a timesheet in that applies these pay rules.

pay rules

  1. Restate the rules as a numbered list. Where a rule is ambiguous, ask in one short list and build with a labelled assumption. Typical gaps: whether daily and weekly overtime stack (the usual approach counts hours once, at the higher applicable rate), which day a shift crossing midnight belongs to (usually the day it started), whether breaks are paid, and the rounding increment and direction.
  2. Settings sheet: named cells for every number in the rules (rate, thresholds, multipliers, break rules, rounding increment, week start).
  3. Daily rows: Date, Employee, Start time, End time, Unpaid break (minutes), and computed columns:
  • Shift length that works across midnight: MOD(End - Start, 1), so 22:00 to 06:00 gives 8 hours.
  • Rounded clock times if the rules round: MROUND to the increment (or FLOOR/CEILING if the rule rounds in one direction), applied to the clock times before subtraction, as the rule says.
  • Paid hours as a decimal: (Shift length - Break / 1440) * 24.
  • Night-premium hours if the rules have them: the overlap of the shift with the night window, computed with MAX(0, MIN(...) - MAX(...)) on both sides of midnight.
  • Daily regular and daily overtime hours from the daily threshold.
  1. Weekly summary per employee: total paid hours, weekly overtime as hours above the weekly threshold minus overtime already counted daily (so nothing is paid twice), regular hours, and pay per category from the Settings rates. Assign rows to weeks with a week-start formula (Date - WEEKDAY(Date, n) + 1 with the right n for the week start day).
  2. Data checks: missing start or end, end equal to start, break longer than the shift, shifts over a maximum length you name, duplicate rows for the same employee and date.
  3. Test cases with expected results computed by hand: a normal day, a shift crossing midnight, a shift ending exactly at midnight, a long day that triggers daily overtime, a week that triggers weekly overtime, and a rounding edge (one minute either side of the rounding point).
constraints
  • Convert to decimal hours (multiply by 24) before multiplying by a pay rate; never multiply a time value by a rate directly.
  • Use only functions available in , comma separators, and note once that some locales use semicolons.
  • No numbers from the rules typed into formulas; use the Settings names.
  • Apply the user's rules as given. Do not state what labour law requires; if a rule looks like it may fall below a legal minimum (unpaid short breaks, rounding that always favours the employer), say in one line that it should be checked against local law or with payroll.
  • Use invented names in examples; remind the user that timesheets are personal data and should be shared only with people who need them.
output format

Rules as understood

Numbered rules with any assumptions marked.

Sheet layout

Sheets, columns and named cells.

Formulas

Table: Column | Formula for row 2 | Notes.

Weekly summary

The summary formulas and how overtime is kept from double counting.

Formatting

Number formats: hh:mm for clock times, [h]:mm for durations that can exceed 24 hours, and 0.00 for decimal hours.

Test cases

Table: Case | Start | End | Break | Expected paid hours | Expected overtime | Expected pay.

Limits

Two to four bullets: time zones and daylight-saving changes, manual edits, what payroll should still check.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Data analysis
category
Spreadsheets
level
Beginner
made for
Operations, People manager, Founder / business owner, Anyone, personal use
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install build-timesheet-calculator --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

pairs well with

All of Spreadsheets
PromptSpreadsheets

Write date and workday formulas

Writes date formulas for working days with holidays, ages, due dates, fiscal periods and week numbers in Excel or Google Sheets, with examples for each. Use when date arithmetic comes out wrong.

calculate-dates-and-workdays
PromptSpreadsheets

Set up data validation for a shared sheet

Sets up data validation, dependent dropdowns, input messages and protected ranges so a shared sheet stays clean, with step-by-step instructions. Use before handing a sheet to other people.

set-up-data-validation
PromptSpreadsheets

Extract tables from a PDF

Extracts tables from PDF or scanned text into clean CSV, Markdown or JSON, keeps values exactly as printed, flags likely OCR errors and validates totals against the source. Use before analysis.

extract-tables-from-pdf
PromptSpreadsheets

Run a what-if analysis

Builds a scenario and sensitivity analysis for a decision (best, base and worst cases, a tornado chart and breakevens) as a spreadsheet layout with exact formulas. Use before committing to a plan.

run-what-if-analysis
PromptSpreadsheets

Audit a spreadsheet model

Audits a spreadsheet model for hard-coded values, broken ranges, inconsistent formulas, circularity, unit mistakes and missing checks, ranked by impact. Use before relying on someone else's sheet.

audit-spreadsheet-model
PromptSpreadsheets

Build a loan amortisation schedule

Builds a loan amortisation schedule in a spreadsheet with payment formulas, extra-payment scenarios and total interest, explaining each column. Use to see how a loan or mortgage pays down.

build-amortization-schedule