Home › Everyday Life › Days Until Calculator

Days Until Calculator

Counts the days from a reference date (default today) to a target date and reports the countdown as weeks and days, approximate months, a calendar breakdown and the target's weekday.

When to use

You need a countdown to an event, deadline or holiday, or how many days ago a date was.

Do not use when: You need business days or an inclusive count between two dates (use date-difference), or an age (use age).

Formula

Inputs

Parameter	Type	Unit	Required	Description
`target_date`	date		yes	The event date (YYYY-MM-DD).
`from_date`	date		default today	Reference date; defaults to the current UTC date.

Outputs

Output	Type	Unit	Description
`days`	integer	days	target_date − from_date; negative when the target is in the past.
`weeks`	integer	weeks	floor(\|days\| / 7).
`remaining_days`	integer	days	\|days\| mod 7.
`months_approx`	number	months	\|days\| / 30.4375 (average Gregorian month).
`calendar_text`	string		Whole years, months and days between the two dates.
`target_weekday`	string		Day of the week of target_date.
`is_past`	boolean		true when target_date is before from_date.
`countdown_text`	string		Days and weeks/days until (or since) the target.

Example

From 2026-09-23 to 2026-12-25: {"target_date":"2026-12-25","from_date":"2026-09-23"} → {"days":93,"weeks":13,"remaining_days":2,"months_approx":3.1,"calendar_text":"3 months 2 days","target_weekday":"Friday","is_past":false,"countdown_text":"93 days (13 weeks 2 days) until 2026-12-25"}

From 2026-01-01 to 2027-01-01: {"target_date":"2027-01-01","from_date":"2026-01-01"} → {"days":365,"weeks":52,"remaining_days":1,"months_approx":12,"calendar_text":"1 year","target_weekday":"Friday","is_past":false}

GET https://tttkmbb.com/api/v1/calculate/days-until?target_date=2026-12-25&from_date=2026-09-23

Machine access

API: GET https://tttkmbb.com/api/v1/calculate/days-until (query parameters) or POST with a JSON body {"inputs": {...}}
Schema: https://tttkmbb.com/api/v1/calculators/days-until · Markdown: https://tttkmbb.com/everyday/days-until.md · JSON definition: https://tttkmbb.com/everyday/days-until.json
MCP: server https://tttkmbb.com/mcp, tool run_calculator with calculator_id="days-until"
OpenAPI operationId: calculate_days_until
Freshness: daily. Authentication: none. Rate limit: fair use (see rate limits).

Sources

Gregorian calendar – leap-year rule and month lengths (Wikipedia) (reference)
ISO 8601 – Date and time format (Wikipedia) (reference)

FAQ

Is the target day itself counted?

No. From Monday to the following Friday is 4 days; the countdown reaches 0 on the target date.

Which time zone is 'today'?

UTC. Near midnight, users in other zones may see a one-day difference; pass from_date explicitly to avoid it.

Related calculators

Date Difference Calculator — Full difference between two dates including business days.
Add or Subtract Days Calculator — Find the date N days from now.