How this instrument works
Different situations call for the gap between two dates to be expressed differently. 'It's 150 days away' is precise and easy to compare against a deadline. '21 weeks away' is easier to plan around week by week. '4 months and 27 days away' is how most people would actually say it out loud. This instrument computes all three framings from the same two input dates, rather than making a choice for you.
The years-months-days figure is not simply the day total divided and rounded — it's a genuine calendar walk: whole years first, then whole months within the remaining span, then whatever days are left over, respecting that months and years are unequal lengths. That's why the number it emphasises can look different from what a naive division of the day total would suggest, even though both are correct descriptions of the same interval.
Use it for anything with a known future date and no dedicated page of its own — a wedding, a product launch, a trip, a concert, or the end of a countdown clock being built for something entirely personal.
- Enter Starting date — it defaults to today.
- Enter Target date — the date being counted down to.
- Read Days until target date and Weeks until target date for the raw totals.
- Read … years, … plus months and … plus days together for the calendar-true breakdown.
- Only need a single day figure, or the years-months-days form without weeks? The Day Countdown and Date Countdown instruments strip this down to those narrower outputs.
Worked example — counting down to Christmas Day 2026
Enter starting date 2026-07-28 and target date 2026-12-25. Days until target date reads 150 and Weeks until target date reads 21. The breakdown reads 0 years, 4 months and 27 days: four full months from 28 July to 28 November, then 27 more days to reach 25 December.
Both views describe the identical 150-day gap — one as a flat total useful for comparing against other countdowns, the other as the phrasing most people would actually use when asked how long is left.
Questions
Why do I get both a day total and a years/months/days breakdown?
Because they serve different purposes. The day total (150) is exact and easy to compare against other deadlines or countdowns; the years/months/days form (0y 4m 27d) is how the same gap would naturally get spoken aloud. Both are computed independently and checked against each other, so they always describe the same underlying span.
Is the week figure just the day total divided by seven?
Yes, with the remainder dropped: 150 days divided by 7 is 21.43, and Weeks until target date reads 21, the complete weeks only. It is not rounded to the nearest week, so it will always read equal to or one week below a naive rounding.
Why might the months figure look different from what I'd expect?
Because months are unequal lengths and the breakdown is calendar-true rather than a fixed 30-day approximation. Four months forward from 28 July lands on 28 November regardless of how many days that actually spanned, and the days column absorbs whatever is left over to reach the target date exactly.
I only want one number, not five outputs — is there a simpler version?
Yes — the Day Countdown instrument returns only the total day count, and Date Countdown returns the day total alongside the years/months/days breakdown but without the week figure. This instrument is the full set; those two are narrower slices of the same underlying calculation.
Can the target date be less than a week away?
Yes — with a target only a few days out, Weeks until target date reads 0, since there isn't yet a complete seven-day span between the two dates, while Days until target date and the years/months/days breakdown still report the shorter gap accurately.
Does this work for a target date that's years away?
Yes, without any special handling — the same calendar walk that produces '0 years, 4 months, 27 days' for a five-month gap produces, for instance, '2 years, 0 months, 0 days' for a target exactly two calendar years out, leap days included in the day total automatically.