Working hours calculator (by country, schedule, and holidays)
If you have ever tried to calculate working hours between two dates, you know it quickly becomes messy.
Not all teams work the same hours.
Not all countries follow the same schedules.
And public holidays can reduce actual working time significantly.
That is why we built a working hours calculator:
working hours calculator
With it, you can:
- calculate total working hours between two dates
- define working hours per day (for example 8h, 7.5h, or shifts)
- include public holidays by country
- narrow results to a specific region or subdivision
- customize working days (for example Sunday to Thursday)
This makes it useful for:
- payroll and salary calculations
- contractor and freelance billing
- project effort estimation
- SLA and support availability tracking
- workforce planning across regions
Instead of approximating hours manually, you get a consistent and accurate result.
Why working hours are harder than working days
Counting days is one thing.
Counting actual working hours is another.
Common problems:
- assuming every working day has the same number of hours
- ignoring part-time or custom schedules
- not accounting for holidays properly
- differences in workweeks across countries
For example:
- 20 working days does not always mean 160 hours
- public holidays can reduce hours unevenly within a month
- teams may operate on 6-hour, 7.5-hour, or shift-based schedules
A proper working hours calculator needs to combine:
- calendar logic
- holiday data
- and customizable schedules
Built on reliable holiday data
The calculator uses the same underlying holiday datasets that power HolidayDB.
That means:
- country-level public holidays are always included
- regional holidays are applied when you select a subdivision
- results stay consistent across different markets
This is especially important for:
- international teams
- global SaaS platforms
- remote-first companies
From quick checks to real planning
You can use the calculator for simple questions like:
- how many working hours are in a month
- how many work hours remain this quarter
But it also supports more advanced use cases:
- estimating project timelines across countries
- calculating billable hours for contractors
- planning staffing and coverage
- validating payroll assumptions
Calculator vs API
The working hours calculator is designed for quick, manual use.
If you need automation or integration into your product, working hours can be derived programmatically using HolidayDB data and business day logic.
This lets you:
- embed calculations into SaaS products
- automate reporting and billing
- keep results consistent between UI and backend
Working hours API (for developers)
If you want to calculate working hours programmatically, use:
GET /api/working-hours
Docs:
Start calculating working hours
- Try the working hours calculator
Use it to validate schedules, payroll, or project estimates.
Accurate working hours are the foundation of planning, billing, and operations. Make sure your numbers reflect reality.
