Date Difference Calculator

What is a date difference calculator?#

A date difference calculator answers a deceptively simple question: how much time lies between two dates? The catch is that “how much time” is not a single number. Forty-seven days is also one month and seventeen days, six weeks and five days, or thirty-three working days — and the answer that matters depends on whether you are tracking a project deadline, computing someone’s age, or counting business days until a launch.

This page gives you all of those readings at once, plus a second mode that shifts a date forward or backward by a given number of days, weeks, months, years, or workdays. All the maths is done in UTC, on whole calendar days, so the result never quietly shifts by an hour when daylight-saving kicks in.

How to use it#

The toolbar at the top switches between two modes.

Difference mode — answer “how long between two dates?”:

1. Enter a From date and a To date (both in YYYY-MM-DD). Click Today to drop the current date into a field.
2. Tick the Units you want reported: days, weeks, months, years, workdays (Monday–Friday). Untick the ones you do not care about to keep the result uncluttered.
3. Tick Inclusive end if both the start and end day should count (for example, “I am on holiday from the 1st through the 10th” usually means ten days, not nine). Leave it off for a pure elapsed-time reading.

Add / Subtract mode — answer “what date is N units from now?”:

1. Enter a base date in From.
2. Enter the Amount — a positive or negative integer (use a minus sign to go backwards).
3. Pick the Unit: day, week, month, year, or workday. Workdays skip Saturdays and Sundays in the stepping direction.

The result card on the right shows the headline figure large, with the other selected units listed below. In Add / Subtract mode it shows the target date in human form plus its ISO YYYY-MM-DD form for easy copying.

Key features#

• Six readings at once. Days, weeks, months, years, workdays, and a calendar breakdown (years + months + days) — not just a single total.
• Time-zone safe. Everything is computed on UTC calendar days, so a viewer in Tokyo and a viewer in Honolulu see the same day count for the same inputs. No DST drift.
• Workday counting. A closed-form weekday count (Mon–Fri) that stays fast even over multi-decade spans — no day-by-day loop.
• Inclusive or exclusive end. One toggle controls whether the last day counts.
• End-of-month clamping. Adding one month to January 31 gives February 28 (or 29 in a leap year), the universally expected behaviour, not March 3.
• Add / Subtract with five units. Including workdays — the unit you actually need when estimating “ten working days from now”.
• No upload, no calendar API. Pure calendar arithmetic in your browser.

Worked example#

A sprint runs from 2026-06-20 to 2026-08-06. Enter those two dates in Difference mode with all units ticked and Inclusive end off. The result card reports:

• 47 days total
• 6 weeks and 5 days
• 1 month 17 days (the calendar breakdown)
• 33 workdays (Monday–Friday)

Now switch to Add / Subtract mode to plan the next milestone. Enter 2026-08-06 in From, set Amount to 30, and pick Unit: workday. The result is 2026-09-17 — the date thirty working days after August 6, with weekends skipped automatically. Try the same with Unit: day and you get 2026-09-05, a clean reminder that “30 days” and “30 workdays” are more than two weeks apart.

FAQ#

Why does the tool use UTC? I only care about local dates.#

Dates are stored and computed as whole calendar days at UTC midnight. That is deliberate: a “day” is then the same unit for everyone, regardless of timezone. If the tool used local time, a viewer in a timezone behind UTC might see the day label shift by one when daylight-saving transitions. UTC avoids that entire class of bug — and since you only enter dates (not times), there is no perceptible difference in the result.

How are workdays counted?#

A workday is any Monday through Friday, inclusive. Saturdays and Sundays are never counted, regardless of country. Public holidays are not subtracted — the tool has no holiday calendar, because holidays are region-specific. If you need to exclude holidays, subtract them manually from the workday figure.

What does “Inclusive end” do?#

It counts both the start day and the end day as part of the span. With it off, the span is pure elapsed time (10 June to 10 July = 30 days). With it on, the span includes both endpoints (10 June to 10 July = 31 days). Most “how many days am I away?” questions want it on; most “how long did the project take?” questions want it off.

What happens when I add a month to the 31st of a month?#

The result clamps to the last valid day of the target month. Adding one month to 2026-01-31 gives 2026-02-28 (2026 is not a leap year); adding one month to 2026-03-31 gives 2026-04-30. This matches what virtually every calendar application does and avoids inventing an “April 31” that does not exist.