Primary formula
Days = end epoch day - start epoch day, adjusted by the selected endpoint rule.
Date & time calculator
Days Between Dates Calculator
Count days between two dates using elapsed or endpoint-inclusive conventions, with signed output when needed.
Last reviewed: July 6, 2026Date-time engine v1.0.0
Date & time calculator
Days Between Dates Calculator
Calculations run locally from the values entered. Endpoint rules, working-day rules and assumptions are labelled in the result.
Deterministic calendar math
Mode
Count days as a positive number.
Enter values and choose Calculate to show the result below the calculator.
Formula and assumptions
Input assumptions
Dates use the Gregorian calendar. Times use entered wall-clock values. No official holiday or timezone database is queried by these calculators.
Precision note
Date calculations use deterministic Gregorian calendar-day arithmetic. Time calculations use entered wall-clock times and do not infer daylight-saving transitions.
Date, time and calendar flow
Parse
Read dates, times, durations and selected endpoint or workday conventions from labelled fields.
Validate
Reject impossible dates, invalid times, negative durations and oversized working-day ranges.
Calculate
Use deterministic TypeScript calendar arithmetic without external date or holiday services.
Label
Show the main result, totals, warnings, assumptions and exportable summaries.
What is the Days Between Dates Calculator?
Days Between Dates Calculator is a NexaCalc date and time tool for counting elapsed days or calendar dates touched. It uses explicit user-entered dates, times and calendar rules so the result can be checked without hidden data feeds.
The calculator is designed for planning and education. Calendar rules can differ by country, workplace, contract or legal context, so important deadlines should be confirmed independently.
How to use the Days Between Dates Calculator
Choose the mode, enter the labelled dates or times, select the endpoint or working-day convention where shown, then press Calculate. Reset restores the built-in example.
Results include the main answer, supporting totals, a short method note, and export actions for quick copying or printing.
Formula and method
Both dates are converted to Gregorian epoch-day numbers. The selected endpoint convention controls which dates are counted.
Calculation example
From 2026-07-01 to 2026-07-05, elapsed mode returns 4 days and include-both mode returns 5 calendar dates.
Assumptions
Dates use the proleptic Gregorian calendar and YYYY-MM-DD input. Time-of-day fields use a 24-hour clock unless a page states another convention.
Limitations
This calculator avoids external paid APIs and does not infer official local holidays, payroll rules, legal filing rules or daylight-saving transitions.
- Endpoint conventions vary by task.
- Business days and holidays are handled by separate tools.
Privacy and performance
Inputs are calculated in the browser session and are not sent to a date, time or calendar API. The deterministic TypeScript engine keeps the page fast on shared hosting.
Frequently asked questions
Does the Days Between Dates Calculator use live external calendar data?
No. Phase 1 date-time tools calculate from the values and calendar rules you enter. Holidays must be entered manually where relevant.
Why do endpoint settings change the answer?
A date span can mean elapsed days or a count of calendar dates touched. NexaCalc labels the endpoint convention so the result is clear.
Does this handle daylight-saving time?
Date calculations use calendar days. Time duration tools use entered wall-clock times and do not infer daylight-saving jumps from locations.
Can I use this for legal or payroll deadlines?
Use it as a planning check only. Official deadlines can depend on local law, holidays, contract language and employer policy.
References
- ISO 8601 date notation for calendar date input format. Source.
- Unicode CLDR weekday and calendar conventions. Source.
- ECMAScript Internationalization API for browser date and number display conventions. Source.
Calendar methods reviewed July 6, 2026.
Educational disclaimer
This calculator provides mathematical results from the values, conventions and methods you enter. Verify important academic, engineering or professional work independently.