Leap day counts in the gap
Inputs: Start 2024-02-28; end 2024-03-01
Result: 2 calendar days
February 29 lies between the endpoints; an inclusive policy would count 3 displayed dates.
Days between two dates calculator
The Days Between Dates calculator measures the elapsed calendar-day gap between valid YYYY-MM-DD inputs. It respects month lengths and leap days. The page displays the absolute number and flags a reversed range; approximate month and year cards are orientation aids, not exact results.
Use the result as elapsed calendar distance for trips, milestones, projects, and date-only planning. It is not an official contract, regulatory, payroll, or legal-age ruling. Record both inputs, endpoint convention, and separate workday, holiday, timezone, or policy rules. reviewedAt records content update and engine testing, not official human review.
How this is calculated
daysBetweenDates computes end date minus start date after normalizing both to the start of their dates. Monday to Tuesday is 1 and the same date is 0. This is not an inclusive count: add one only when a policy counts both endpoints. It is not a weekday, business-day, holiday, overnight, or legal-age calculation. Approximate months and years use average-length divisors, so retain the day result.
Assumptions and limits
- Inputs are date-only YYYY-MM-DD values; no clock time or IANA timezone is selected.
- The UI uses Math.abs for its main card, while the engine retains direction for reversed inputs.
- Business-day ranges include both endpoints and can exclude supplied holidays. Deadline advancement excludes the start, reduces a positive amount by one when the start is eligible, and is currently weekend-only because it has no regional holiday selector.
- The age parent fix in progress clamps Feb 29 birthdays to Feb 28 in non-leap years and normalizes years, months, and days. That is a planning convention, not legal-age advice.
- Duration uses browser-local date-time values with no IANA selector; calendar components and total seconds differ. The timezone parent fix rejects DST gaps, while a repeated fall-back hour needs offset confirmation.
Worked examples
January is not an automatic 30-day month
Inputs: Start 2026-01-01; end 2026-01-31
Result: 30 calendar days
The engine measures the gap; an inclusive rule would count 31 dates.
Reversed inputs preserve engine direction
Inputs: Start 2026-09-07; end 2026-09-04
Result: 3 displayed; engine value -3
The UI shows the absolute gap and says the end comes first; reverse inputs for a forward countdown.
Boundary cases
- Same-day inputs return 0 elapsed days, although an inclusive one-day request may count that date as 1.
- Feb 28 to Mar 1 is 2 days in a leap year and 1 in a non-leap year, changing deadline and milestone plans by one day.
- Reversed inputs are negative in the engine but unsigned in the UI, so downstream schedules must inspect order.
- Invalid or malformed dates produce the invalid state rather than an approximate answer.
- Month-end and year-end ranges can differ from 30-day or 365-day shortcuts; record the convention.
Common mistakes
- Treating the displayed value as inclusive without documenting the endpoint rule.
- Using this page for workdays, holidays, or a promise that requires a holiday-adjusted calendar.
- Replacing calendar arithmetic with months × 30 or years × 365.
- Ignoring reversed inputs or treating approximate month/year cards as exact periods.
- Calling a date-only gap a timezone-aware duration when DST or offsets control the decision.
Continue your planning
Calendar Days vs Business Days: Which Count Should You Use?
Content updated · Maintained by NoteMide · Report a correction
Frequently asked questions
Are the start and end dates included?
The main number is the elapsed gap: January 1 to January 31 is 30 days. Add one only when both endpoints must count, and label it inclusive.
What does a reversed range mean?
The engine returns a negative difference when the end precedes the start. The UI displays the absolute value and identifies that the end comes first.
Does it include leap years?
Yes. Calendar-aware subtraction includes February 29 when the selected year has it.
Can it count workdays or holidays?
No. Use Business Days for weekday and selected-holiday counting, then verify the employer or regional rule.
Why are months and years approximate?
Calendar months and years have unequal lengths, so those cards use average-length estimates. Keep the day count for exact planning.