Date Difference Calculator — Days & Duration Between Two Dates

What is Date Diff?

A date difference calculator returns the exact duration between two moments in time. Simple-looking, but easy to get subtly wrong: dividing total days by 30.44 (average month length) or 365.25 (average year length) yields fractional results that don't match how a human would answer 'how long between January 15 and March 15?'. The correct approach — calendar borrowing — is what this page uses. Both dates are treated as local calendar days by default (or local wall-clock time when the 'Include time' toggle is on), and results are reported both as a natural language expression ('3 years, 5 months, 12 days') and as raw totals for each common unit.

How to calculate the duration between two dates

1. 1Enter the 'from' date and the 'to' date. Order doesn't matter — the tool will flag reversed inputs.
2. 2Toggle 'Include time' if you need hour / minute precision (defaults to daily precision).
3. 3Read the primary result: the duration in years, months, and days, borrowed the way a human would compute it.
4. 4Scroll down for the total time span in weeks, days, hours, minutes, seconds, and business days.
5. 5Use the swap button to reverse the direction and the display will update instantly.

Use Cases

Code Examples

function calendarDuration(from, to) {
  let years = to.getFullYear() - from.getFullYear();
  let months = to.getMonth() - from.getMonth();
  let days = to.getDate() - from.getDate();
  if (days < 0) {
    // Borrow days from the previous month of `to`
    days += new Date(to.getFullYear(), to.getMonth(), 0).getDate();
    months -= 1;
  }
  if (months < 0) {
    months += 12;
    years -= 1;
  }
  return { years, months, days };
}

from dateutil.relativedelta import relativedelta
from datetime import date

diff = relativedelta(date(2027, 3, 15), date(2024, 1, 5))
print(diff.years, diff.months, diff.days)

Key Concepts

Calendar borrowing

When computing a duration, if the 'to' day-of-month is smaller than the 'from' day-of-month, one month is borrowed from the total. The borrowed month's day count depends on the specific month — that's why the naive 30.44-day average is wrong.

Business days

Monday through Friday, ignoring public holidays. Because holidays vary by country and jurisdiction, this tool does not deduct them — for payroll or SLA calculations, subtract them manually.

DST transitions

When 'Include time' is on and the interval crosses a daylight-saving transition, one specific day of that interval is 23 or 25 hours long in local time. Total hours reflects this; total days does not.

Leap seconds

JavaScript's Date API ignores leap seconds — the total-seconds count is off by up to ~30 seconds when spanning decades. For scientific timing accuracy, use a specialized library.

Tips & Best Practices

• ▸For scheduling code, prefer libraries like date-fns, luxon, or Temporal (once it ships natively). They handle timezone-aware arithmetic more safely than raw Date math.
• ▸The business-days count includes both the from and to date when they fall on a weekday. If you need exclusive counting (e.g. 'weekdays elapsed since'), subtract 1 from the reported total.
• ▸When spanning across February, remember: 'one month later' is not always exactly 30 days. Feb 15 + 1 month = Mar 15, which is 28 or 29 actual days.
• ▸For non-Gregorian calendars (Hebrew, Islamic, Chinese lunar), this tool is not the right choice — Gregorian is baked in.