{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"days-until"},"result":{"entity_type":"calculator","id":"days-until","calculator_id":"days-until","canonical_url":"https://tttkmbb.com/everyday/days-until","name":"Days Until Calculator","title":"Days Until Calculator – Countdown in Days, Weeks and Months to a Date","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_days_until","featured_mcp_tool":false,"description":"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.","use_when":"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).","inputs":[{"name":"target_date","label":"Target date","type":"date","required":true,"description":"The event date (YYYY-MM-DD).","example":"2026-12-25"},{"name":"from_date","label":"Count from","type":"date","required":false,"default":"today","description":"Reference date; defaults to the current UTC date.","example":"2026-09-23"}],"outputs":[{"name":"days","label":"Days","type":"integer","unit":"days","decimals":4,"description":"target_date − from_date; negative when the target is in the past."},{"name":"weeks","label":"Whole weeks","type":"integer","unit":"weeks","decimals":4,"description":"floor(|days| / 7)."},{"name":"remaining_days","label":"Remaining days","type":"integer","unit":"days","decimals":4,"description":"|days| mod 7."},{"name":"months_approx","label":"Months (approx.)","type":"number","unit":"months","decimals":1,"description":"|days| / 30.4375 (average Gregorian month)."},{"name":"calendar_text","label":"Calendar difference","type":"string","decimals":4,"description":"Whole years, months and days between the two dates."},{"name":"target_weekday","label":"Weekday of target","type":"string","decimals":4,"description":"Day of the week of target_date."},{"name":"is_past","label":"Target is in the past","type":"boolean","decimals":4,"description":"true when target_date is before from_date."},{"name":"countdown_text","label":"Countdown","type":"string","decimals":4,"description":"Days and weeks/days until (or since) the target."}],"input_schema":{"type":"object","properties":{"target_date":{"description":"The event date (YYYY-MM-DD).","type":"string","format":"date","examples":["2026-12-25"]},"from_date":{"description":"Reference date; defaults to the current UTC date.","type":"string","format":"date","default":"today","examples":["2026-09-23"]}},"additionalProperties":false,"required":["target_date"]},"output_schema":{"type":"object","properties":{"days":{"description":"target_date − from_date; negative when the target is in the past. Unit: days.","type":"integer","x-unit":"days"},"weeks":{"description":"floor(|days| / 7). Unit: weeks.","type":"integer","x-unit":"weeks"},"remaining_days":{"description":"|days| mod 7. Unit: days.","type":"integer","x-unit":"days"},"months_approx":{"description":"|days| / 30.4375 (average Gregorian month). Unit: months.","type":"number","x-unit":"months"},"calendar_text":{"description":"Whole years, months and days between the two dates.","type":"string"},"target_weekday":{"description":"Day of the week of target_date.","type":"string"},"is_past":{"description":"true when target_date is before from_date.","type":"boolean"},"countdown_text":{"description":"Days and weeks/days until (or since) the target.","type":"string"}}},"formula":"days = target_date − from_date; weeks = floor(|days| / 7); remaining_days = |days| mod 7; months_approx = |days| / 30.4375","sources":[{"name":"Gregorian calendar – leap-year rule and month lengths (Wikipedia)","url":"https://en.wikipedia.org/wiki/Gregorian_calendar","type":"reference","retrieved_at":"2026-09-23"},{"name":"ISO 8601 – Date and time format (Wikipedia)","url":"https://en.wikipedia.org/wiki/ISO_8601","type":"reference","retrieved_at":"2026-09-23"}],"freshness":{"type":"daily","max_age_seconds":86400,"note":"Depends on the current date unless the date is supplied."},"examples":[{"name":"From 2026-09-23 to 2026-12-25","inputs":{"target_date":"2026-12-25","from_date":"2026-09-23"},"expected":{"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"},"url":"https://tttkmbb.com/api/v1/calculate/days-until?target_date=2026-12-25&from_date=2026-09-23"},{"name":"From 2026-01-01 to 2027-01-01","inputs":{"target_date":"2027-01-01","from_date":"2026-01-01"},"expected":{"days":365,"weeks":52,"remaining_days":1,"months_approx":12,"calendar_text":"1 year","target_weekday":"Friday","is_past":false},"url":"https://tttkmbb.com/api/v1/calculate/days-until?target_date=2027-01-01&from_date=2026-01-01"}],"faq":[{"q":"Is the target day itself counted?","a":"No. From Monday to the following Friday is 4 days; the countdown reaches 0 on the target date."},{"q":"Which time zone is 'today'?","a":"UTC. Near midnight, users in other zones may see a one-day difference; pass from_date explicitly to avoid it."}],"tags":["days until","countdown","how many days until","days left","days ago"],"related":[{"calculator_id":"date-difference","reason":"Full difference between two dates including business days."},{"calculator_id":"add-days","reason":"Find the date N days from now."}],"links":{"html":"https://tttkmbb.com/everyday/days-until","markdown":"https://tttkmbb.com/everyday/days-until.md","json":"https://tttkmbb.com/everyday/days-until.json","api":"https://tttkmbb.com/api/v1/calculate/days-until","schema":"https://tttkmbb.com/api/v1/calculators/days-until","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:25:36Z","next_actions":[{"tool":"run_calculator","calculator_id":"days-until","reason":"Run Days Until Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/days-until.md"}}