{
  "id": "days-until-school-starts",
  "version": "5f89f7345e5a",
  "status": "published",
  "name": "Days Until School Starts",
  "question": "How many days until school starts?",
  "summary": "Counts the days and weeks from today, or any date, to the first day of school.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-school-starts",
  "markdown": "https://www.acalculator.org/days/days-until-school-starts.md",
  "kind": "function",
  "method": "days = first day of school − start date, in calendar days; weeks = days ÷ 7 rounded down, with the days left.",
  "assumptions": [
    "The start date is not counted and the first day of school is: from the day before, the count is 1; on the first day, it is 0.",
    "With the first day left empty, the page counts to the first first day of school on or after the start date in Northside ISD’s published calendars (San Antonio, Texas): August 10, 2026 (2026–27) or August 9, 2027 (2027–28), and names the school year. After August 9, 2027, enter a date.",
    "A first day of school before the start date has no answer.",
    "Dates from January 1, 2000 to December 31, 2100 work. Dates are calendar days with no time of day."
  ],
  "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. It is not counted.",
        "type": "string",
        "format": "date"
      },
      "first": {
        "title": "First day of school",
        "description": "Your school’s first day, from its calendar. Left empty, the page counts to an example: the next first day of school of Northside ISD, San Antonio, Texas.",
        "type": "string",
        "format": "date"
      }
    }
  },
  "outputs": {
    "days": {
      "label": "Days until school starts",
      "description": "Calendar days from the start date to the first day of school; 0 on the first day itself.",
      "format": "integer"
    },
    "weeks": {
      "label": "In weeks",
      "description": "The calendar days as whole weeks and days.",
      "format": "text"
    },
    "date": {
      "label": "First day of school",
      "description": "The first day of school counted to.",
      "format": "date-long"
    },
    "example": {
      "label": "Example calendar",
      "description": "The district calendar the first day comes from, when the box is left empty.",
      "format": "text"
    }
  },
  "defaultAnswer": {
    "inputs": {
      "from": "2026-10-19"
    },
    "outputs": {
      "days": 294,
      "weeks": "42 weeks",
      "date": "2027-08-09",
      "example": "Northside ISD, San Antonio, Texas, 2027–28 school year"
    },
    "text": "From October 19, 2026, there are 294 days until the first day of school, Monday, August 9, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2026-10-19"
      },
      "expect": {
        "days": 294,
        "weeks": "42 weeks",
        "date": "2027-08-09",
        "example": "Northside ISD, San Antonio, Texas, 2027–28 school year"
      },
      "source": "Northside ISD, Calendars (https://www.nisd.net/schools/calendars) and Board approves instructional calendars (https://www.nisd.net/news/board-approves-instructional-calendars): first days of school August 10, 2026 and August 9, 2027; hand calculation in content.mdx; Python 3 cross-check in docs/progress/WP-141/crosscheck.py"
    },
    {
      "given": {
        "from": "2026-08-01"
      },
      "expect": {
        "days": 9,
        "weeks": "1 week and 2 days",
        "date": "2026-08-10",
        "example": "Northside ISD, San Antonio, Texas, 2026–27 school year"
      },
      "source": "Northside ISD, Calendars (https://www.nisd.net/schools/calendars) and Board approves instructional calendars (https://www.nisd.net/news/board-approves-instructional-calendars): first days of school August 10, 2026 and August 9, 2027; hand calculation in content.mdx; Python 3 cross-check in docs/progress/WP-141/crosscheck.py"
    },
    {
      "given": {
        "from": "2027-06-01",
        "first": "2027-08-09"
      },
      "expect": {
        "days": 69,
        "weeks": "9 weeks and 6 days",
        "date": "2027-08-09"
      },
      "source": "Northside ISD, Calendars (https://www.nisd.net/schools/calendars) and Board approves instructional calendars (https://www.nisd.net/news/board-approves-instructional-calendars): first days of school August 10, 2026 and August 9, 2027; hand calculation in content.mdx; Python 3 cross-check in docs/progress/WP-141/crosscheck.py"
    },
    {
      "given": {
        "from": "2027-07-04",
        "first": "2027-09-09"
      },
      "expect": {
        "days": 67,
        "weeks": "9 weeks and 4 days",
        "date": "2027-09-09"
      },
      "source": "hand calculation in content.mdx; Python 3 cross-check in docs/progress/WP-141/crosscheck.py"
    },
    {
      "given": {
        "from": "2027-08-09",
        "first": "2027-08-09"
      },
      "expect": {
        "days": 0,
        "weeks": "0 days",
        "date": "2027-08-09"
      },
      "source": "hand calculation in content.mdx"
    }
  ],
  "sources": [
    "Northside ISD, Calendars: the 2026–27 calendar, “Aug. 10: First Day of School” (retrieved 2026-10-19). https://www.nisd.net/schools/calendars",
    "Northside ISD, Board approves instructional calendars, December 9, 2025: first day of school on Aug. 10, 2026 and Aug. 9, 2027 (retrieved 2026-10-19). https://www.nisd.net/news/board-approves-instructional-calendars",
    "New York City Public Schools, 2026–2027 School Year Calendar: first day of school, September 10 (retrieved 2026-10-19). https://www.schools.nyc.gov/calendar/2026-2027-school-year-calendar"
  ],
  "related": [
    "days-until-school-ends",
    "days-until",
    "days-between-dates",
    "days-from-today"
  ],
  "changelog": []
}