Business days calculator: working days in a month or full year
This page is a free business days calculator backed by HolidayDB public holiday data. Pick a country, optional subdivision, year, and either a single month or the full calendar year. The count answers a practical question: how many working days in a month (or year) remain after national and, when you select a region, subnational holidays fall on days you treat as work?
The on-page tool uses the same rules as GET /api/business-days. If you need the logic in code, that endpoint is the business days API path to use in production, with authentication and plan limits described in the documentation.
Payroll calendar and HR planning
Teams building a payroll calendar or doing HR planning often start from calendar months, then subtract holidays that apply to each employee group. A working-days view per country (and region, where data exists) gives a consistent baseline before you add company-specific closures. Use the calculator for spot checks and spreadsheets; use the API when dates need to stay in sync with your source of truth for public holidays.
Business days API and public holidays API
HolidayDB splits concerns cleanly. The public holidays API (for example GET /api/holidays) returns holiday rows with scopes you can filter. The business days API (GET /api/business-days) returns counts and ranges built from that same dataset plus your choice of which weekdays count. Together they cover "what is off" and "how many on days remain" without hand-maintaining calendars per jurisdiction.
ISO weekdays, regional public holidays, and subnational codes
By default, Monday through Friday count. You can override this with ISO weekday numbers (1 is Monday through 7 is Sunday) when your schedule is not a classic five-day week. National holidays always apply for the selected country. When you choose a subdivision, regional public holidays for that ISO 3166-2 code are removed in addition to national ones; the API accepts the same region parameter. Plans that include subdivision coverage apply the same way as for the holidays API; check the docs for your tier.
International teams and more than one country
Some companies have staff in several countries. Each country has its own public holidays, so one magic number for "the whole world" usually is not helpful. HolidayDB answers one country at a time: set country, add region when you care about state or province rules, then read the count. If you need a wider picture, run the calculator or API once per place and add the results in your own app or spreadsheet. Remote workers follow the same idea: pick the country and region that best matches where their holidays come from, then use that pair for their working-day count.
Using this in your own software
This page is for trying the product in the browser. For apps, backends, and scripts, call GET /api/business-days with an API key. Parameters such as weekdays, region, and date inputs are described in the business-days section of the HolidayDB documentation.