What is a Date Difference Calculator?
A date difference calculator counts the time between two calendar dates. The obvious answer — the number of days — is the one people rarely need on its own, so this tool reports the same interval several ways at once: total days, weeks and leftover days, a calendar breakdown in years, months and days, total months, and the number of working days.
The calendar breakdown is the part worth understanding. It is not simply total days divided by anything, because months are different lengths. The tool walks the calendar instead: 31 January to 28 February is 28 days and reads as 0 months, 28 days, not as 1 month. That is also how age is normally stated, which makes this the same arithmetic an age calculator performs.
The other mode adds or subtracts a duration from a date. Adding months is done calendar-wise too, so 31 January plus one month gives 28 February in a non-leap year rather than 3 March. Everything is calculated in UTC, so a daylight-saving change never adds or removes an hour from a day count.
How to count the days between two dates
- Choose Between two dates for a difference, or Add or subtract to move a date by a duration.
- For a difference, set the From and To dates — Fill today puts the current date in any empty field. If the end date is earlier than the start, the count is shown as an absolute value with a note rather than a negative number.
- Read the headline: total days. Below it, the cards give weeks and days, the calendar breakdown, total months, hours, business days and working hours at eight hours a day.
- To exclude public holidays from the business-day count, list them in the holiday box as YYYY-MM-DD separated by commas. Any date listed that falls on a Monday to Friday is removed from the count.
- For Add or subtract, pick a start date, an amount and a unit — days, weeks, months, years or business days. A negative amount subtracts.
Date Difference Calculator limits and rules
| Item | Limit |
|---|---|
| Total days | Exact whole days between the two dates, counted in UTC |
| Calendar breakdown | Years, months and days, walked month by month rather than averaged |
| Total months | Whole calendar months, signed |
| Business days | Monday to Friday, minus any holiday you list — capped at a 20,000-day scan |
| Working hours | Business days multiplied by 8 — a stated assumption, not a timesheet |
| Adding months | Calendar-based: 31 January + 1 month = 28 February (or 29 in a leap year) |
| Business-day arithmetic | Weekends skipped, listed holidays skipped; nothing else is treated as a non-working day |
| Time zones | Everything is UTC, so DST transitions never shift a count by an hour |
| Date format | YYYY-MM-DD internally; the browser's own date picker handles input in your locale |
| Not covered | Time-of-day arithmetic, durations in seconds, recurring schedules and timezone conversion |
When to use it
- Checking a notice period, a cooling-off window or a contract deadline in calendar days rather than in weeks you have to count by hand.
- Working out how many working days remain before a launch date, with public holidays subtracted, when the answer has to exclude weekends.
- Reading a timesheet period as weeks and days, or confirming how many days a project actually ran.
- Counting down to an event, an exam or a visa deadline, where the total days figure is the one that matters.
- Adding a fixed number of months to a start date for a subscription, a warranty or a repayment schedule, and seeing where the calendar-month edge lands.
Is it private?
Everything runs inside your browser. Your text and files are never uploaded, never stored and never seen by anyone else — including me. You can use the tool with the network tab open and watch no request leave the page. Closing the tab erases the input.
Frequently asked questions
Exclusive of the start date. 1 January to 2 January is 1 day, which matches how most legal and contractual periods are counted. The business-day count does include the start date, because a working-day counter that skipped day one would undercount a full week.
Saturday and Sunday are excluded, so a full week is 5 business days. That is a general convention, not a universal rule — countries with a different weekend cannot be configured here. Holidays are excluded only if you list them.
Because the calendar breakdown is not an average. From 31 January to 28 February, no complete month has passed, so the answer is 0 months and 28 days. Averaging would tell you it is about one month, which is true but not the answer a person would give.
Total months ignores the leftover days — 65 days is about 2 months. The calendar breakdown keeps them: 2 months, 4 days. Which one you want depends on whether you are measuring duration or restating a date.
It sidesteps them. All arithmetic is done on UTC dates, so a day is always exactly 24 hours. If you counted local wall-clock hours instead, the two DST Sundays each year would produce a 23- or 25-hour day and a fractional result.
Related tools
Written and maintained by Md. Nur Hossain Repon.