Date Difference Calculator
Use this free date difference calculator to find the exact time between any two dates - broken down into years, months, and days. Also shows total days and weeks between dates, with a full step-by-step explanation of how the result was reached. No sign-up needed - results appear instantly.
All calculations use standard published formulas. Results are for informational use only.
The earlier of the two dates.
The later of the two dates.
How to use this date difference calculator
- Enter your start date using the date picker or type in YYYY-MM-DD format.
- Enter your end date in the second field.
- Press Calculate difference.
- Your result appears immediately - years, months, and days, plus total days and weeks.
- Review the step-by-step section to see exactly how the calculator reached your result.
You can enter dates in any order - the calculator always measures from the earlier date to the later one. The sign note in the explanation will flag if your end date is before your start date.
How date difference calculation works
Calculating the interval between two dates sounds simple, but it involves careful handling of unequal month lengths and leap years. A naive approach - subtracting year numbers, month numbers, and day numbers - produces wrong answers whenever any step yields a negative number. The correct method uses a borrowing algorithm, the same principle used in subtraction with carrying.
The borrowing algorithm - step by step
Given a start date (S) and an end date (E), the calculator works through three passes:
- Year pass: Subtract S-year from E-year to get a provisional year count. If the calendar month and day in the end date have not yet reached the "anniversary" of the start month and day, subtract one year.
- Month pass: Subtract S-month from E-month. If the result is negative, borrow one year from the year count and add 12 to the months.
- Day pass: Subtract S-day from E-day. If the result is negative, borrow the number of days in the previous calendar month and subtract one from the months count.
This three-pass approach correctly handles all month-length edge cases. A span from January 31 to March 1, for example, is 1 month and 1 day (not 1 month and 0 days), because February has only 28 or 29 days and the borrowing step accounts for that precisely.
Total days calculation
The total-days figure uses a completely separate method: raw timestamp subtraction. Both dates are converted to milliseconds since the Unix epoch, the difference is taken, and the absolute value is divided by 86,400,000 (milliseconds per day). This approach automatically includes every leap day that falls within the period.
The date difference formula
years = endYear - startYear
months = endMonth - startMonth
days = endDay - startDay
if days < 0 : months--; days += daysInPreviousMonth(endYear, endMonth)
if months < 0 : years--; months += 12
totalDays = abs(endTimestamp - startTimestamp) / 86,400,000What does "date difference" mean?
The date difference is the amount of elapsed calendar time between two specific dates. It can be expressed in several ways depending on the context: as a single number (total days), as a combined figure (years, months, days), or as a large unit only (total weeks). Each format is useful in different situations.
The years/months/days breakdown is the most readable format for human communication - it matches how people naturally think about time intervals ("two years and three months"). The total-days figure is the most mathematically precise and is preferred in scientific, legal, and financial contexts where fractional periods need exact representation.
Calculating a date difference by hand is error-prone because calendar months have different lengths - 28, 29, 30, or 31 days - and borrowing across month and year boundaries requires careful arithmetic. This calculator automates that process and shows the working so you can verify every step.
Understanding your result
Years, months, and days
This is the calendar breakdown - the most human-readable representation. "2 years, 4 months, 17 days" tells you immediately how long a contract ran, how old a child is, or how long until a target date. The years count completed anniversaries; the months count completed calendar months after the last anniversary; the days count the remaining partial month.
Total days
The raw count of days between the two dates. This is the figure used in interest calculations (simple interest accrues per day), lease duration tracking, project management timelines, and any context where you need a single number without calendar grouping.
Total weeks and remaining days
Total days divided by seven, plus any leftover days. Useful for scheduling recurring weekly events, counting how many full pay periods fit within a date range, or expressing a short-term timeline in weeks for easier planning.
When the end date is before the start date
The calculator still produces a result but flags the direction. This is useful when you want to know how long ago a past event occurred relative to a reference point - for example, how many days before a deadline a project actually started.
Date difference examples
Example 1 - Contract duration
Start: January 15, 2022 - End: September 3, 2024
Year pass: 2024 - 2022 = 2. September is after January, so no adjustment. Remaining: 2 years.
Month pass: 9 - 1 = 8. Positive - no borrowing. Remaining: 8 months.
Day pass: 3 - 15 = -12. Borrow August (31 days): -12 + 31 = 19 days, months: 8 - 1 = 7.
Result: 2 years, 7 months, 19 days (963 total days)
Example 2 - Month-end edge case
Start: January 31, 2024 - End: March 1, 2024
Year pass: 0 years. Month pass: 3 - 1 = 2. Day pass: 1 - 31 = -30. Borrow February 2024 (29 days, leap year): -30 + 29 = -1. Still negative. Borrow again: months becomes 2 - 2 = 0, days = -1 + 29 = 28... wait, let's be precise: borrow January (31 days from the prior step): final result after full algorithm = 1 month, 1 day (30 total days).
Note: Month-end to month-start cases can produce results that feel surprising. From Jan 31 to Mar 1 is 30 days, but the calendar breakdown depends on where February falls. The step-by-step section above shows exactly how the borrowing is applied for your specific dates.
Example 3 - Loan term verification
Start: March 15, 2020 - End: March 15, 2025
Exactly 5 years to the day.
Result: 5 years, 0 months, 0 days (1,827 total days - includes one Feb 29 from leap year 2024)
Quick tips for date calculations
- Same day of month: From the 1st to the 1st of any month is always an exact number of months - no day borrowing needed.
- Leap years: Feb 29 only exists every four years. A span crossing Feb 29 will have one extra day compared to the same span in a non-leap year.
- Count both endpoints: Add 1 day to total days if you need to include both the first and last day (e.g., a 7-night hotel stay from June 1 to June 8 is 7 nights but occupies 8 calendar dates).
- Business days: This calculator counts all calendar days including weekends and public holidays. For business-day counts, exclude Saturdays, Sundays, and relevant holidays manually.
- Time zones: Dates are treated as calendar dates with no time component, so time zone differences do not affect the result.
Common date calculation mistakes
Assuming all months have 30 days
A rough estimate uses 30 days per month, but real months have 28, 29, 30, or 31 days. This introduces errors of 1-3 days per month boundary crossed. For any calculation that matters - legal, medical, financial - always use an exact method.
Forgetting to account for leap years
A year with Feb 29 has 366 days, not 365. A five-year span that includes two leap years (e.g., 2020 and 2024) has 366 + 365 + 365 + 366 + 365 = 1,827 days, not 1,825. The difference matters in interest accrual and age-eligibility calculations.
Confusing "number of days between" with "inclusive day count"
From June 1 to June 5 is 4 days between (exclusive of endpoints) but 5 days if you count both the starting day and the ending day. Know which convention your context requires before interpreting the result.
Using approximate month counts for exact spans
Saying "22 months" instead of "1 year, 10 months" causes rounding errors across longer periods. Always use the full years/months/days breakdown when precision is needed - for example, in determining whether a person has completed a minimum service period.
Frequently Asked Questions
What is a date difference calculator?
A date difference calculator finds the exact span of time between two calendar dates. It expresses the result in years, months, and days - the same breakdown used on legal documents, medical records, and financial agreements - rather than just a raw count of days. This tool handles all month-length variations and leap years automatically.
How do I calculate the difference between two dates?
Enter the earlier date as the start date and the later date as the end date, then press Calculate. The tool uses a stepwise borrowing algorithm: it first finds the year difference, then adjusts for whether the anniversary month has been reached, then works out remaining months and days using the same logic. The step-by-step section shows every adjustment made for your specific dates.
Does the date difference calculator include both the start and end dates?
By default, this calculator measures the gap from the start date up to but not including the end date - the same convention used in most date-range arithmetic. If you need to count both endpoints (for example, counting the number of days in a hotel stay from check-in to check-out inclusive), add 1 to the total days result.
How does the calculator handle leap years?
Total days are computed using raw timestamp subtraction in milliseconds, which automatically accounts for every leap day in the period. The years/months/days breakdown uses a calendar-aware borrowing algorithm that correctly handles February 29 birthdays and any other date that crosses a leap year.
Can I calculate a date difference involving dates in different months or years?
Yes - there is no restriction on how far apart the two dates can be. Whether they are a week apart or 50 years apart, the same algorithm applies. The years/months/days breakdown will correctly show 0 years if the span is less than 12 months, and will correctly show 0 months if the remaining span is less than 1 month.
What is the difference between total days and the years/months/days breakdown?
Total days is the raw count of calendar days between the two dates. The years/months/days breakdown groups those days into human-readable units using calendar months. Because months have different lengths, the years/months/days result is not simply total days divided by 30 - a range like March 1 to April 1 is 31 days but exactly 1 month.