Time FIELD NOTES · 4 MIN READ
Workdays and Date Math: Adding Days Without Weekend Surprises
Calendar days and workdays disagree: weekends and holidays eat about 29 percent of the days. How to count, add, and promise in workdays without landing on a Sunday.
Add "30 days" to a contract and you get one date; add "20 workdays" and you get another, three or four weekends apart. Both counts measure the same spinning Earth, yet they answer different questions — and mixing them up is exactly how deadlines land on Sundays.
Two calendars stacked on one page
A calendar day is every sunrise, weekends included. A workday is a sunrise minus the weekend days and holidays your context excludes. In the default Saturday-Sunday world, two days in every seven vanish — about 28.6 percent of the calendar — so a 30-calendar-day span holds roughly 21 or 22 workdays. But the ratio is only an average: a 7-day window can contain four or five workdays depending on where it starts, which is why honest workday math walks the calendar day by day instead of multiplying:
Mon Oct 19 → Fri Oct 30, 2026
12 calendar days, 2 weekends excluded → 10 workdays
Counting the gap between two dates
The Workday Calculator does that walk for a span: every day is checked, weekend days are excluded under a weekend mode you pick, and holidays are skipped on top. Weekend modes matter more than people expect — Saturday-Sunday is the default, but Friday-Saturday fits a different work week, and Sunday-only fits industries that run six days. Holidays can be given as fixed dates or as recurring annual dates (month-day, so 01-01 covers every New Year's Day in the range).
One boundary decision changes the count: whether the end date itself counts. Christmas week shows both levers at once:
Dec 21 – Dec 25, 2026, end date included:
5 weekdays (Mon–Fri), Christmas excluded as a holiday → 4 workdays
Adding days so the deadline lands midweek
Adding workdays is the other direction: "N workdays from now" means the Nth working day after the start — the start day itself is never counted, even if it is a workday. The calendar distance is always at least N days and usually more, because every full week in between eats two weekend days:
Fri Oct 23, 2026 + 5 workdays → Fri Oct 30 (7 calendar days)
Fri Oct 23, 2026 + 10 workdays → Fri Nov 6 (14 calendar days)
A useful rule of thumb: N workdays ≈ N calendar days plus two weekend days per full week — 5 becomes 7, 10 becomes 14, 20 becomes 28 — and then every holiday inside the window adds one more day on top. Adding calendar days instead ignores weekends entirely, and the two answers drift apart: 10 plain days from Friday, October 23 lands Monday, November 2, while 10 workdays lands Friday, November 6 — the same "10," four days apart. Pick the unit that matches the promise you are keeping.
Months and years: the units that do not sit still
Days and weeks are rigid; months are not. The Date Adder applies years first, then months, then days (with weeks converted to 7 days each), and month arithmetic is calendar-aware — which produces the famous month-end overflow. January 31 plus one month means "February 31," a date that does not exist, so the extra days spill into March:
2026-01-31 + 1 month → 2026-03-03 (common year: Feb has 28, 3 days spill)
2024-01-31 + 1 month → 2024-03-02 (leap year: Feb has 29, 2 spill)
2024-02-29 + 1 year → 2025-03-01 (the anniversary itself doesn't exist)
None of these is an error — they are what "a month later" has to mean when the destination month is too short. Note that the leap-day anniversary slides to March 1 in common years and returns to February 29 four years later, the same normalization age calculators make (see how leap years work for why February is the calendar's problem child).
Measuring a span vs moving along it
The Date Difference Calculator answers "how much time sits between two dates": exact days (signed, so order matters), weeks plus remaining days, total hours and minutes — and approximate months and years, computed with a 365.25-day year and a 30.44-day month. The approximation is deliberate: converting a day count into years exactly would require walking the calendar, because months differ. Exact days are always trustworthy; the years-and-months breakdown is for human orientation.
So the workflow is: measure gaps with exact days, add spans with the units the promise was made in, and let a workday walk handle anything with the word "business" in it. For the general machinery of counting toward a target date, see how a date countdown works.
Try it yourself
Count a two-week span with the Workday Calculator, then flip the weekend mode and watch the count change. Add 10 workdays to today's date with a couple of holidays listed and compare the result with adding 14 plain days on the Date Adder — including a month-end date like January 31. Measure the true gap with the Date Difference Calculator and note where its months-and-years answer is marked approximate.