Article — Date Calculator
Date Calculator: Days Between Dates, Date Arithmetic, and Today's Date
A date calculator handles three jobs: counting days between two dates, adding or subtracting an interval from a given date, and reporting facts about today (weekday, ISO format, day of year, week of year, Julian Day Number). This tool does all three with leap-year-correct arithmetic, business-day support, and a Julian Day output for astronomy or scientific work. Pick a mode, enter dates, read the answer.
The math under the hood is the same regardless of mode. Each calendar date converts to a Julian Day Number — a continuous integer count of days starting from January 1, 4713 BC. Subtracting two JDNs gives an exact day count without month-length or leap-year edge cases. Adding an integer to a JDN and converting back produces a future or past date.
What the date calculator does
This date calculator runs three modes from a single interface. Between mode finds the calendar gap between two dates: total days, weeks, business days (Monday through Friday), and years. Add / Subtract mode shifts a starting date forward or backward by days, weeks, months, years, or business days, returning the result date with weekday and ISO format. Today mode displays the current date with its weekday name, ISO 8601 string, day of year, week of year, and Julian Day Number.
Each mode uses native browser date pickers, so month lengths, leap years, and Gregorian calendar rules are handled by the underlying JavaScript Date object. That eliminates the most common date-math errors: counting February 29 incorrectly in a leap year, miscounting days across month boundaries, and getting the weekday wrong for historical or future dates.
Days between dates mode
The Between mode answers "how many days from A to B?" — useful for project planning, contract terms, gestational age, days since an event, or simply counting down to a birthday. Enter start and end dates. The headline number is total days. Below it: weeks plus extra days, business days only, total years (decimal), and the hours-equivalent for fine-grained scheduling.
If you enter dates in reverse order (end before start), the calculator detects it, swaps internally, and notes the reversal in the formula display. The result is always non-negative. Business days exclude Saturdays and Sundays but do not subtract public holidays — those vary by country (US has 11 federal holidays; UK has 8 bank holidays; Germany varies by state) and adding them automatically would require a country selector and a holiday database.
The longest gap any calculator needs to handle is roughly 8,000 years — the span from the start of recorded history to a few millennia in the future. That is about 2.9 million days. JavaScript's Date object supports the range from year -271,821 to year +275,760, comfortably covering any practical date math.
Date arithmetic: add and subtract
Add / Subtract mode shifts a date by a chosen interval. Pick the operation (add or subtract), the amount, and the unit (days, weeks, months, years, or business days). Common uses: project deadlines ("90 days from contract signing"), shipping ETAs ("delivered in 5 business days"), maturity dates ("180-day note"), gestational milestones, contract anniversaries, and HR leave accruals.
The result respects calendar rules. Adding 1 day to February 28, 2024 lands on February 29 (leap year). Adding 1 day to February 28, 2025 lands on March 1 (non-leap). Adding 1 month to January 31 lands on February 28 in regular years and February 29 in leap years — there is no February 31, so the calculator clamps to the last valid day. Adding 1 year to February 29, 2024 also clamps, landing on February 28, 2025.
+30 days ~1 month+90 days ~3 months / 1 quarter+365 days 1 year (366 in leap)+7 days same weekday next week+10 biz days 2 work weeks+1 quarter 3 calendar monthsBusiness day date math
Business days exclude weekends. The calculator iterates day by day from start to end, counting only Monday through Friday. For Add / Subtract mode with "business days" as the unit, it skips weekends as it walks: adding 5 business days from a Monday lands on the next Monday, not Saturday. Adding 10 business days from a Monday lands two weeks out.
Public holidays are not subtracted automatically. The US has 11 federal holidays per year. The UK has 8 bank holidays. Germany varies from 9 to 13 depending on the state. Many shipping and contract calculators silently apply a US holiday list, which is wrong for international users. If your calculation must exclude holidays, do the business-day math, then subtract holidays manually from the result.
Leap years and date calculations
A year is a leap year if it is divisible by 4, except for years divisible by 100, unless also divisible by 400. So 2024 is a leap year, 2025 is not, 2100 is not (divisible by 100 but not 400), and 2000 was (divisible by 400). The Gregorian leap rule keeps the calendar aligned with the solar year to within one day every ~3,200 years.
The most common date-math error is forgetting that February has 29 days in leap years. A 365-day note signed on January 1, 2024 matures on December 31, 2024 — not January 1, 2025 — because 2024 had 366 days. Counting 30 days from January 30, 2024 lands on February 29, 2024 (the 30th day). Software that ignores leap years produces silent off-by-one errors that compound over multi-year intervals.
Julian Day and ISO date formats
The Julian Day Number (JDN) is a continuous integer day count starting January 1, 4713 BC at noon UTC. Today (May 2026) is roughly JDN 2,461,000. Astronomers, NASA, the U.S. Naval Observatory, and most scientific software use JDN to do date math because subtraction yields an exact day count regardless of calendar reforms, leap years, or month length.
ISO 8601 (YYYY-MM-DD) is the international standard for written dates. It sorts correctly as text, eliminates the ambiguity between US (MM/DD/YYYY) and European (DD/MM/YYYY) formats, and is the format every database, API, and programming language uses internally. "2026-05-14" is unambiguously May 14, 2026 in any country.
- Leap year rule = divisible by 4, except by 100 unless also by 400
- Days in a year = 365, or 366 in a leap year
- Business days in a year = 260 - 261 (5 days × 52 weeks)
- Average month length = 30.44 days
- ISO 8601 format = YYYY-MM-DD
- Julian Day = continuous integer day count from 4713 BC
- Week 1 per ISO 8601 contains the first Thursday of January
Common date calculator pitfalls
The first pitfall is the inclusive vs. exclusive endpoint question. "30 days from January 1" can mean January 30 (exclusive of start, counted from day 0) or January 31 (inclusive, counted from day 1). Contracts and statutes need to specify which. This calculator uses exclusive counting in Between mode (the difference between Jan 1 and Jan 31 is 30 days) and additive arithmetic in Add / Subtract mode (adding 30 to Jan 1 yields Jan 31).
The second pitfall is ignoring leap years. Adding 1 year to February 29, 2024 has no exact answer — the calculator clamps to February 28, 2025. The third is the month-end clamp: adding 1 month to January 31 clamps to February 28 or 29. The fourth is silent timezone conversion: ISO date strings with time components can shift by a day if parsed in a different timezone. This calculator uses local-time date construction to avoid that.
Business-day calculations here exclude weekends only. They do not subtract public holidays, because holidays differ by country and state. A shipping ETA of "5 business days" from a US carrier accounts for US federal holidays; the same ETA from a German carrier accounts for German Land holidays. Always confirm holiday handling with the originating party.
When sharing dates internationally, always use ISO 8601 format (YYYY-MM-DD). "05/06/2026" is May 6 to an American and June 5 to a European. "2026-05-06" is May 6 to everyone. Database fields, API payloads, and spreadsheet exports should all use ISO format to avoid quarterly miscommunications.