What this tool does
Compare two dates and inspect elapsed days and total time. Strict YYYY-MM-DD dates are parsed at UTC midnight. The earlier date is used first for a positive duration; reversed input order is flagged. Complete calendar months are counted with missing anniversary days clamped to month end, then split into years and months. Weeks and days are the remainder after those months; total days, hours, minutes and seconds are separate elapsed totals.
How to use Date Difference Calculator
- Prepare the input. Choose both dates with the date controls.
- Run or configure the tool. Select Calculate Difference.
- Check and use the output. Distinguish the calendar remainder from the separate elapsed totals.
How this tool works
Strict YYYY-MM-DD dates are parsed at UTC midnight. The earlier date is used first for a positive duration; reversed input order is flagged. Complete calendar months are counted with missing anniversary days clamped to month end, then split into years and months. Weeks and days are the remainder after those months; total days, hours, minutes and seconds are separate elapsed totals.
Worked example
Input: Start 2020-01-01; end 2020-01-03
Output: 2 elapsed days; 48 hours; 2,880 minutes; 172,800 seconds.
Limits, assumptions and interpretation
The difference is elapsed duration, not an inclusive count of both dates. Invalid dates and year 0000 are rejected.
- No time-of-day, holiday calendar or business-day rules are included.
- Calendar months vary in length. For example, January 31 to February 28 in a non-leap year is one complete clamped month; use total days when you need an elapsed-day count.
- The interface does not calculate a legal deadline or payroll entitlement.
Supported inputs and limits
- Start 2020-01-01; end 2020-01-03
- The difference is elapsed duration, not an inclusive count of both dates. Invalid dates and year 0000 are rejected.
- No time-of-day, holiday calendar or business-day rules are included.
- Calendar months vary in length. For example, January 31 to February 28 in a non-leap year is one complete clamped month; use total days when you need an elapsed-day count.
- The interface does not calculate a legal deadline or payroll entitlement.
Frequently asked questions
What does this tool actually do?
Strict YYYY-MM-DD dates are parsed at UTC midnight. The earlier date is used first for a positive duration; reversed input order is flagged. Complete calendar months are counted with missing anniversary days clamped to month end, then split into years and months. Weeks and days are the remainder after those months; total days, hours, minutes and seconds are separate elapsed totals.
What should I check before using the result?
The difference is elapsed duration, not an inclusive count of both dates. Invalid dates and year 0000 are rejected. No time-of-day, holiday calendar or business-day rules are included. Calendar months vary in length. For example, January 31 to February 28 in a non-leap year is one complete clamped month; use total days when you need an elapsed-day count. The interface does not calculate a legal deadline or payroll entitlement.
Is information sent to a server?
Tool inputs are processed in this browser. This product does not use analytics or send your input to an external API. Clicking an external website link still visits that website.