{
  "id": "days-until-january",
  "version": "e1d78996221a",
  "status": "published",
  "name": "Days Until January",
  "question": "Days until January",
  "summary": "Counts the days from today, or any date you choose, to January 1, the first day of the next January, with its weekday and the time in weeks and months.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-january",
  "markdown": "https://www.acalculator.org/days/days-until-january.md",
  "kind": "function",
  "method": "Find the first January 1 on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "The count is to January 1, the first day of the month. During January, it counts to January 1 of the next year.",
    "The start date itself is not counted: from the day before, the count is 1; on the day itself, it is 0.",
    "Dates are calendar days with no time of day, so a time zone or a daylight-saving change never adds or loses a day.",
    "Start dates from January 1, 1900 to December 31, 2400 work."
  ],
  "inputs": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "from": {
        "title": "Count from",
        "description": "The date to count from. Today, unless you change it.",
        "type": "string",
        "format": "date"
      }
    }
  },
  "outputs": {
    "days": {
      "label": "Days until January",
      "description": "Whole days from the start date to the next January 1; 0 on January 1 itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next January 1 on or after the start date.",
      "format": "date-long"
    },
    "weekday": {
      "label": "Day of the week",
      "description": "The weekday of that January 1.",
      "format": "text"
    },
    "weeks": {
      "label": "In weeks",
      "description": "The same number of days in weeks and days.",
      "format": "text"
    },
    "months": {
      "label": "In months and days",
      "description": "The time to that date in whole months, then days.",
      "format": "duration"
    }
  },
  "defaultAnswer": {
    "inputs": {
      "from": "2026-09-30"
    },
    "outputs": {
      "days": 93,
      "date": "2027-01-01",
      "weekday": "Friday",
      "weeks": "13 weeks and 2 days",
      "months": {
        "years": 0,
        "months": 3,
        "days": 2
      }
    },
    "text": "From September 30, 2026, there are 93 days until January on Friday, January 1, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2026-09-28"
      },
      "expect": {
        "date": "2027-01-01",
        "days": 95,
        "weekday": "Friday"
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime: the next first of the month on or after the start date (docs/progress/WP-45/truth.py)"
    },
    {
      "given": {
        "from": "2026-01-01"
      },
      "expect": {
        "date": "2026-01-01",
        "days": 0,
        "weekday": "Thursday"
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime: the next first of the month on or after the start date (docs/progress/WP-45/truth.py)"
    },
    {
      "given": {
        "from": "2026-01-02"
      },
      "expect": {
        "date": "2027-01-01",
        "days": 364,
        "weekday": "Friday"
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime: the next first of the month on or after the start date (docs/progress/WP-45/truth.py)"
    },
    {
      "given": {
        "from": "2028-02-29"
      },
      "expect": {
        "date": "2029-01-01",
        "days": 307,
        "weekday": "Monday"
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime: the next first of the month on or after the start date (docs/progress/WP-45/truth.py)"
    }
  ],
  "sources": [],
  "related": [
    "days-until-december",
    "days-until-february",
    "days-until",
    "days-between-dates"
  ],
  "changelog": []
}