{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"work-hours"},"result":{"entity_type":"calculator","id":"work-hours","calculator_id":"work-hours","canonical_url":"https://tttkmbb.com/everyday/work-hours","name":"Work Hours Calculator","title":"Work Hours Calculator – Daily, Weekly, Monthly and Annual Hours and Pay from Shift Times","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_work_hours","featured_mcp_tool":false,"description":"Derives paid hours per day from shift start and end times minus unpaid breaks, scales them to a week (working days), an average month (52/12 weeks) and a year (52 weeks), and multiplies by an optional hourly rate for pay.","use_when":"You want to know your working hours per week, month or year from a daily schedule, or the pay they represent at an hourly rate.","do_not_use_when":"Shifts vary day by day (sum each with time-duration), or you need salary conversions between periods without shift times (use salary-converter).","inputs":[{"name":"start_time","label":"Shift start","type":"string","required":true,"description":"Start of the working day, 24-hour HH:MM.","example":"09:00"},{"name":"end_time","label":"Shift end","type":"string","required":true,"description":"End of the working day, 24-hour HH:MM (an end time before the start time means the shift ends the next day).","example":"17:30"},{"name":"break_minutes","label":"Unpaid break","type":"integer","unit":"min","required":false,"default":0,"min":0,"max":1440,"description":"Unpaid break minutes per day.","example":30},{"name":"days_per_week","label":"Working days per week","type":"integer","unit":"days","required":false,"default":5,"min":1,"max":7,"description":"Number of such working days per week.","example":5},{"name":"hourly_rate","label":"Hourly rate","type":"number","required":false,"min":0,"max":100000,"description":"Optional gross pay per hour; adds pay outputs.","example":25}],"outputs":[{"name":"hours_per_day","label":"Hours per day","type":"number","unit":"h","decimals":2,"description":"(end − start − break) in hours."},{"name":"hours_per_week","label":"Hours per week","type":"number","unit":"h","decimals":2,"description":"hours_per_day × days_per_week."},{"name":"hours_per_month","label":"Hours per month","type":"number","unit":"h","decimals":2,"description":"hours_per_week × 52 / 12 (average month)."},{"name":"hours_per_year","label":"Hours per year","type":"number","unit":"h","decimals":1,"description":"hours_per_week × 52 (no holidays or leave deducted)."},{"name":"daily_pay","label":"Pay per day","type":"number","decimals":2,"description":"hours_per_day × hourly_rate (only when hourly_rate is given)."},{"name":"weekly_pay","label":"Pay per week","type":"number","decimals":2,"description":"hours_per_week × hourly_rate."},{"name":"monthly_pay","label":"Pay per month","type":"number","decimals":2,"description":"hours_per_month × hourly_rate."},{"name":"annual_pay","label":"Pay per year","type":"number","decimals":2,"description":"hours_per_year × hourly_rate (gross, before tax)."}],"input_schema":{"type":"object","properties":{"start_time":{"description":"Start of the working day, 24-hour HH:MM.","type":"string","examples":["09:00"]},"end_time":{"description":"End of the working day, 24-hour HH:MM (an end time before the start time means the shift ends the next day).","type":"string","examples":["17:30"]},"break_minutes":{"description":"Unpaid break minutes per day. Unit: min.","type":"integer","minimum":0,"maximum":1440,"default":0,"examples":[30],"x-unit":"min"},"days_per_week":{"description":"Number of such working days per week. Unit: days.","type":"integer","minimum":1,"maximum":7,"default":5,"examples":[5],"x-unit":"days"},"hourly_rate":{"description":"Optional gross pay per hour; adds pay outputs.","type":"number","minimum":0,"maximum":100000,"examples":[25]}},"additionalProperties":false,"required":["start_time","end_time"]},"output_schema":{"type":"object","properties":{"hours_per_day":{"description":"(end − start − break) in hours. Unit: h.","type":"number","x-unit":"h"},"hours_per_week":{"description":"hours_per_day × days_per_week. Unit: h.","type":"number","x-unit":"h"},"hours_per_month":{"description":"hours_per_week × 52 / 12 (average month). Unit: h.","type":"number","x-unit":"h"},"hours_per_year":{"description":"hours_per_week × 52 (no holidays or leave deducted). Unit: h.","type":"number","x-unit":"h"},"daily_pay":{"description":"hours_per_day × hourly_rate (only when hourly_rate is given).","type":"number"},"weekly_pay":{"description":"hours_per_week × hourly_rate.","type":"number"},"monthly_pay":{"description":"hours_per_month × hourly_rate.","type":"number"},"annual_pay":{"description":"hours_per_year × hourly_rate (gross, before tax).","type":"number"}}},"formula":"hours_per_day = (end_time − start_time (+24 h if negative) − break_minutes) / 60; week = × days_per_week; month = week × 52 / 12; year = week × 52; pay = hours × hourly_rate","method":"A year is taken as exactly 52 weeks (2,080 h for a 40-hour week); the US OPM uses 2,087 h to average leap years. Public holidays, sick days and paid leave are not deducted, and overtime premiums are not applied.","sources":[{"name":"US OPM – Computing Hourly Rates of Pay Using the 2,087-Hour Divisor","url":"https://www.opm.gov/policy-data-oversight/pay-leave/pay-administration/fact-sheets/computing-hourly-rates-of-pay-using-the-2087-hour-divisor/","type":"government","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"09:00–17:30, 30 min break, 5 days, 25/h","inputs":{"start_time":"09:00","end_time":"17:30","break_minutes":30,"days_per_week":5,"hourly_rate":25},"expected":{"hours_per_day":8,"hours_per_week":40,"hours_per_month":173.33,"hours_per_year":2080,"daily_pay":200,"weekly_pay":1000,"monthly_pay":4333.33,"annual_pay":52000},"url":"https://tttkmbb.com/api/v1/calculate/work-hours?start_time=09%3A00&end_time=17%3A30&break_minutes=30&days_per_week=5&hourly_rate=25"},{"name":"Night shift 22:00–06:00, 45 min break, 4 days","inputs":{"start_time":"22:00","end_time":"06:00","break_minutes":45,"days_per_week":4},"expected":{"hours_per_day":7.25,"hours_per_week":29,"hours_per_month":125.67,"hours_per_year":1508},"url":"https://tttkmbb.com/api/v1/calculate/work-hours?start_time=22%3A00&end_time=06%3A00&break_minutes=45&days_per_week=4"}],"faq":[{"q":"Why 52/12 = 4.333 weeks per month?","a":"Months have 28–31 days, so payroll conventionally uses the average of 52 weeks divided by 12 months (about 173.33 h for a 40-hour week) rather than exactly 4 weeks."},{"q":"Is the break paid?","a":"break_minutes is subtracted as unpaid time. If your breaks are paid, enter 0."}],"tags":["work hours calculator","hours per week","hours per month","timesheet","hourly pay"],"related":[{"calculator_id":"time-duration","reason":"Length of a single shift."},{"calculator_id":"salary-converter","reason":"Convert hourly pay to monthly or annual salary."}],"links":{"html":"https://tttkmbb.com/everyday/work-hours","markdown":"https://tttkmbb.com/everyday/work-hours.md","json":"https://tttkmbb.com/everyday/work-hours.json","api":"https://tttkmbb.com/api/v1/calculate/work-hours","schema":"https://tttkmbb.com/api/v1/calculators/work-hours","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:25:35Z","next_actions":[{"tool":"run_calculator","calculator_id":"work-hours","reason":"Run Work Hours Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/work-hours.md"}}