Working days and business days calculator

Count the working days between two dates for more than 150 countries. The actor takes any number of date ranges and returns, for each one, the working days left after removing weekends and public holidays. It runs fully offline from a pinned copy of the holidays library, so there is no API key and nothing to break.

What it does

Give it a start date and an end date and a country. It walks every day in the range and sorts each into weekend, public holiday, or working day. You get one clean row per query with the counts and the list of holidays that fell inside the range.

Typical uses:

• Payroll and billing periods where you pay per working day.
• Project and delivery estimates that skip weekends and national holidays.
• SLA and contract windows measured in business days.
• Leave and PTO planning across different countries.

Input

• queries: a list of date ranges. Each item takes startDate and endDate in YYYY-MM-DD format, plus an optional country (ISO code like US, GB, DE, FR) and subdivision (like ENG for England or CA for California).
• weekendDays: which weekdays count as weekend, where 0 is Monday and 6 is Sunday. Defaults to Saturday and Sunday. Set it to [4, 5] for a Friday and Saturday weekend.

If a range is entered backwards, the actor swaps the dates and flags it with datesReversed.

Output

One row per query with these fields:

• startDate, endDate: the normalized range.
• country, subdivision: what was used for the holiday calendar.
• calendarDays: total days in the range, inclusive.
• weekendDays: days that fell on a weekend.
• publicHolidays: holidays that fell on a working weekday.
• workingDays: days left after removing weekends and holidays.
• holidaysInRange: the dated list of holidays inside the range.
• datesReversed: true if the input dates were swapped.
• error: filled only when a query could not be processed.

Results export to JSON, CSV, or Excel from the dataset.

Notes

Holiday coverage comes from the holidays library and follows official national calendars. Regional accuracy depends on passing the right subdivision. Countries observe holidays differently, so treat the working day count as the standard national reckoning, not local company policy.