What Is the Workdays Calculator?
The Workdays Calculator helps you count business days (working days) between any two dates, or find a specific date by adding or subtracting a number of workdays. Unlike a simple date calculator, it automatically excludes weekends and public holidays from the count — and can even estimate your salary for the period.
This tool is essential for anyone who needs to work with business timelines — whether you're planning project deadlines, calculating delivery dates, managing employee leave, determining contract durations, or estimating pay.
Two Calculation Modes
Count Workdays
Add Workdays
Visual Calendar View
A color-coded calendar displays your date range at a glance. Green cells represent workdays, gray cells are weekends, and amber cells highlight holidays — hover over any holiday to see its name. Start and end dates are marked with distinct colors for easy identification.
Salary Estimation
Enter a daily rate in Options and the calculator instantly shows your estimated total salary for the workdays in range. Supports decimal values for precise rates. The formula breakdown (workdays × rate = total) is displayed for transparency.
Holiday Support
Select from 20+ countries to automatically exclude national public holidays. The calculator supports both fixed-date holidays and lunar calendar holidays such as Tết Nguyên Đán (Vietnam), Chuseok and Seollal (South Korea), Chinese New Year, and Mid-Autumn Festival. You can also add your own custom holiday dates.
Flexible Weekend Settings
Not all countries use Saturday-Sunday weekends. Choose from multiple weekend configurations including Friday-Saturday (common in Middle Eastern countries), Friday only, Thursday-Friday, or Sunday only to match your region's work schedule.
How to Use the Workdays Calculator
Count Workdays Between Two Dates
Select Mode
Make sure the Count Workdays tab is selected.
Choose Dates
Pick a Start Date and End Date using the date pickers, or click Today to quickly set today's date.
View Results
The number of workdays appears instantly in the result card.
Swap Dates (Optional)
To swap the two dates, click the swap button (↔) between the date fields.
Add or Subtract Workdays
Switch Mode
Switch to the Add Workdays tab.
Select Start Date
Choose your starting date using the date picker.
Set Direction
Choose Add or Subtract to set the direction.
Enter Workdays
Enter the number of workdays, or click a quick preset (5, 10, 15, 20, 30, 60, 90).
Get Result
The resulting calendar date appears instantly.
Configure Options
Open Settings
Click Options to expand the settings panel.
End Date Inclusion
Include end date — Check this to count the end date itself as a day in Count mode.
Weekend Configuration
Weekend — Choose which days are non-working days (Sat-Sun, Fri-Sat, Fri only, Thu-Fri, or Sun only).
Salary Rate
Daily rate — Enter your pay per workday (supports decimals) to see a salary estimation in the results.
Holiday Selection
Holidays — Select a country to automatically exclude its public holidays from the calculation.
Custom Holidays
Custom holidays — Click "Add date" to manually add specific dates as holidays (company holidays, personal days off, etc.).
View Results
Below the main result, you'll find comprehensive information about your calculation:
Breakdown Card
Detailed breakdown of your date range:
- Total calendar days
- Weekends skipped
- Holidays skipped
Period Info Card
Additional time metrics:
- Total weeks
- Approximate months
- Start/end day names
Salary Estimation
Total pay based on workdays × daily rate (only shown when a rate is entered).
Holidays in Range
A list of every public holiday that falls within your date range.
Calendar View
A visual month-by-month calendar with color-coded days. Scroll horizontally to view all months. Hover over amber (holiday) cells to see the holiday name.
Copy Results
Click the Copy Result button to copy a formatted summary of the calculation (including salary if entered) to your clipboard.
Features
Dual Calculation Modes
Switch between Count Workdays (find business days between two dates) and Add Workdays (find a date after a given number of business days). Both modes share the same weekend and holiday settings.
Visual Calendar View
A month-by-month calendar renders your entire date range with color-coded cells for instant visual understanding. Scroll horizontally to navigate across months. Supports up to 36 months.
- Green — Workdays
- Gray — Weekend days
- Amber — Public holidays (hover to see name)
- Indigo — Start date
- Red — End date
- Orange border — Today
Salary Estimation
Enter a daily rate in Options to instantly calculate your estimated total salary for the workdays in range. The salary card displays the total amount and a transparent formula (workdays × rate = total). Supports decimal values for precise rates. The salary is also included when copying results.
Country Holiday Database
Built-in public holiday data for over 20 countries including the United States, United Kingdom, Canada, Australia, New Zealand, Germany, France, Italy, Spain, Netherlands, Japan, South Korea, Vietnam, China, India, Singapore, Thailand, Brazil, Mexico, and the Philippines. Holidays are calculated accurately for any year, including movable holidays like Easter, Thanksgiving, and lunar calendar dates.
Lunar Calendar Holidays
Accurate calculation of holidays based on the Chinese lunar calendar:
- Vietnam — Tết Nguyên Đán (7 days), Giỗ Tổ Hùng Vương
- South Korea — Seollal (3 days), Chuseok (3 days), Buddha's Birthday
- China — Spring Festival, Dragon Boat Festival, Mid-Autumn Festival
- Singapore — Chinese New Year (2 days), Vesak Day
Custom Weekend Configuration
Five weekend options to match different regional work schedules: Saturday-Sunday, Friday-Saturday, Friday only, Thursday-Friday, and Sunday only.
Custom Holiday Dates
Add any dates as custom holidays — useful for company-specific holidays, bridge days, or personal days off. Custom holidays are saved and persist across sessions.
Detailed Breakdown
Every calculation includes a complete breakdown: total calendar days, weekends skipped, holidays skipped, total weeks, approximate months, and the weekday of start and end dates.
Holidays in Range
When a country is selected, view a complete list of all public holidays within your date range, showing each holiday's date, day of the week, and name.
Quick Presets
In Add Workdays mode, use preset buttons (5, 10, 15, 20, 30, 60, 90 days) for common business timeframes like one-week, two-week, or monthly deadlines.
Auto-Calculate
Results update instantly as you change any input — no need to click a calculate button.
State Persistence
Your selections (dates, weekend type, country, custom holidays, daily rate, active tab) are automatically saved and restored when you return to the calculator.
Frequently Asked Questions
What are workdays (business days)?
Workdays or business days are the days of the week when most businesses operate — typically Monday through Friday. This calculator excludes weekends and optionally excludes public holidays from the count.
Does this calculator include public holidays?
Yes. Select a country from the Holidays dropdown in Options, and the calculator will automatically exclude that country's public holidays. You can also add custom holiday dates manually.
How are lunar calendar holidays calculated?
For countries like Vietnam, South Korea, China, and Singapore, the calculator uses a lunar-to-solar calendar conversion library to accurately determine the Gregorian dates of holidays like Tết Nguyên Đán, Seollal, Chuseok, and Chinese New Year for any given year.
What does "Include end date" mean?
By default, the calculator counts days from the start date up to (but not including) the end date. Enabling "Include end date" adds the end date itself to the count, so the total is one day higher if the end date is a workday.
Why is the weekend not Saturday-Sunday in some countries?
Different countries have different official weekends. For example, many Middle Eastern countries observe Friday-Saturday as the weekend, while some observe only Friday. The calculator provides five weekend options to accommodate different regional work schedules.
How does the salary estimation work?
Enter your daily rate (pay per workday) in the Options panel. The calculator multiplies the number of workdays by your daily rate to show the estimated total salary. It supports decimal values for precise rates. The salary is displayed in a separate card with a formula breakdown, and is included when you copy the results.
What do the colors mean in the Calendar View?
The calendar uses color coding:
- Green for workdays
- Gray for weekends
- Amber for holidays
- Indigo for the start date
- Red for the end date
- Orange border for today
Hover over any amber (holiday) cell to see the holiday name in a tooltip.
Can I add my own holidays?
Yes. Click "Add date" in the Custom holidays section under Options. You can add as many dates as needed — for example, company holidays, bridge days, or personal days off. Custom holidays are saved in your browser and will persist when you revisit the page.
Is my data stored or sent anywhere?
No. All calculations happen entirely in your browser. No dates, settings, or results are sent to any server. Your preferences are saved locally in your browser's storage.
What is the maximum date range supported?
The calculator supports dates from 1900 to 2100. Lunar calendar conversion is available for this entire range, ensuring accurate holiday calculations for past and future dates.
How does "Add Workdays" handle holidays?
When adding workdays, the calculator skips over both weekends and holidays. For example, if you add 1 workday from a Thursday and Friday is a holiday, the result will be the following Monday (assuming Saturday-Sunday weekends).
No comments yet. Be the first to comment!