About the Date Difference Calculator
A date difference calculator works out the gap between two dates in years, months, days, weeks, and total days — and optionally in workdays only (excluding weekends and, with care, public holidays). It is one of the most-used pieces of everyday arithmetic: project deadlines, contract durations, age calculation, anniversaries, and tax-year planning all start with "how many days between these two dates".
Date arithmetic looks simple but is full of edge cases: leap years, the day-of-month-boundary mismatch at month ends, and the difference between calendar months and elapsed-day months. This calculator implements the canonical "years, months, days" decomposition along with a precise total-days count, both useful in different contexts.
Years/months/days versus total days
Two ways to express a duration. "1 year 2 months 14 days" matches how humans talk; "440 days" is what software, contracts, and statisticians need. The two are not interchangeable — converting 440 days back into "years/months/days" depends on which months the period straddles. Always show both forms for clarity.
Workdays and public holidays
Workday counts exclude Saturdays and Sundays. They do not automatically exclude public holidays — those vary by country and by year. For accurate workday counts (project delivery dates, payroll cycles), confirm against your local holiday calendar.
How to use the Date Difference Calculator
Pick the two dates
Use the date pickers or type YYYY-MM-DD.
Read the breakdown
Years/months/days, total days, weeks, months, and workdays appear together.
Swap order if needed
The tool handles either order; the absolute difference is reported regardless.
Worked examples
Example 1
Input: 2020-01-15 to 2026-06-06
Result: 6 years 4 months 22 days · 2,335 total days
A typical multi-year duration.
Example 2
Input: 2026-01-01 to 2026-12-31
Result: 11 months 30 days · 364 total days
A non-leap calendar year is 365 days; from Jan 1 to Dec 31 is 364 days inclusive of neither endpoint or 365 inclusive.
Real-world use cases
- Calculating the term of a contract or lease.
- Counting workdays for project planning and delivery dates.
- Working out how long ago a historical event was.
- Computing age in days for medical or actuarial contexts.
- Setting deadline countdowns for tax filings, exams, or product launches.
Tips & common mistakes
- For legal and contract purposes, prefer the "Y years M months D days" form to avoid ambiguity about how to convert days back to a calendar period.
- Workday counts ignore public holidays — adjust manually based on the relevant jurisdiction.
- For inclusive vs exclusive day counts, be explicit. "5 days from Monday" typically means Saturday in plain English but exact contracts may differ.
Frequently asked questions
Does it handle dates before 1900?
Yes, using the proleptic Gregorian calendar. The result is consistent and machine-checkable but historically the Julian calendar was used before 1582 in much of Europe.
Are time zones considered?
No — dates are treated as calendar values, not instants. This matches how almost all "days between" arithmetic works in practice.
How are leap years handled?
Correctly. 29 February is included in the day count when the period spans it.
Related tools
Last updated: June 2026 · All processing happens locally in your browser.