📆Date Difference Calculator — Calculate Days, Weeks, Months & Years Between Two Dates

Date arithmetic is dominated by the Gregorian calendar, which Pope Gregory XIII introduced through the bull Inter gravissimas in 1582 to correct the drift accumulated under the Julian calendar. The reform skipped ten days (Thursday 4 October 1582 was followed by Friday 15 October 1582 in Catholic Europe) and revised the leap-year rule to keep the calendar year aligned with the tropical year. Different countries adopted the reform at different times — Britain and its colonies waited until 1752, Russia until 1918, Greece until 1923 — so for any historical research before 1923 you may have to pick which of the two calendars to count in. The calculator uses the proleptic Gregorian calendar, which extrapolates today's rule backwards in time even before 1582; this is the convention used by ISO 8601 and almost all modern programming languages, including JavaScript, Python and SQL.

The leap-year rule is precise: a year is a leap year if it is divisible by 4, except for century years, which must additionally be divisible by 400. So 1900 was not a leap year, but 2000 was; 2100, 2200 and 2300 will not be, but 2400 will. This rule produces an average year length of 365.2425 days, only about 27 seconds longer than the actual mean tropical year of roughly 365.2422 days — accurate enough that the next correction is not expected for several thousand years. The calculator applies the rule mechanically when computing the day count of any span that crosses 29 February.

Under the hood, the most reliable way to compute the difference between two dates is to convert each date to its Julian Day Number (JDN), an integer counting elapsed days since 1 January 4713 BC in the proleptic Julian calendar — and subtract. The Fliegel–Van Flandern formula (Communications of the ACM, 1968) gives JDN directly from the Y/M/D triple in a closed form using only integer arithmetic and integer division, avoiding any floating-point error. Once both endpoints are JDNs, the difference in days is simply JDN_end − JDN_start. From there the converter expresses the same span in weeks (÷ 7), hours (× 24), minutes (× 1440) and seconds (× 86400). For 'business days' the calculator iterates over each date in the span and counts only Monday–Friday (weekday derivation uses Sakamoto's algorithm or, equivalently, Zeller's congruence). Public-holiday handling is intentionally not country-specific because public-holiday calendars change every year and differ even between regions of the same country (e.g. German Länder, Swiss cantons, Spanish autonomous communities); the calculator therefore reports raw weekday-based working days and lets the user subtract national or regional holidays manually.

The calendar breakdown into years/months/days is more subtle than total-day counting because months have variable length (28, 29, 30 or 31 days). The standard procedure is: take Y_end − Y_start as the year delta, then M_end − M_start as the month delta, then D_end − D_start as the day delta; if D_delta is negative, borrow one month from M_delta and add the number of days in the previous month; if M_delta is then negative, borrow one year from Y_delta and add 12 months. This is exactly how every official 'years/months/days' breakdown works, including German Lebensjahre/Monate/Tage, Romanian ani/luni/zile and the US 'age in years, months, days' standard used on legal forms. Note that 'one month' is therefore not a fixed length: from 31 January to 28 February is 'one month' (and also 28 days), while from 31 January to 1 March is 'one month and one day' (and 29 or 30 days depending on the year). Both views — calendar breakdown and absolute day count — are correct simultaneously because they answer different questions.

Date format is a frequent source of error in cross-border use. ISO 8601, the international standard published in 1988 and revised in 2019, prescribes YYYY-MM-DD with a four-digit year and zero-padded month and day; this representation sorts correctly as a string and is unambiguous globally. The American convention MM/DD/YYYY and the European DD/MM/YYYY look identical for dates such as 03/04/2025 (which can mean either 3 April or 4 March), so any contract, lease or international shipment is best dated in ISO 8601 to avoid disputes. The calculator outputs ISO format by default and accepts ISO input on every locale.

Leap seconds, the additional second occasionally inserted into UTC by the International Earth Rotation and Reference Systems Service (IERS) to keep clock time aligned with Earth's rotation, are intentionally ignored in date-difference calculations: civil dates do not include them, and counting them would misalign with how legal deadlines, contracts, ages and government records are computed. This is also the convention of every major operating system clock when handling civil time. For everyday and legal use this calculator's output therefore matches official documents to the second.