{
  "id": "days-until-hanukkah",
  "version": "c47c38e31951",
  "status": "published",
  "name": "Days Until Hanukkah",
  "question": "Days until Hanukkah",
  "summary": "Counts the days from today, or any date you choose, to the next Hanukkah, with its date and day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-hanukkah",
  "markdown": "https://www.acalculator.org/days/days-until-hanukkah.md",
  "kind": "function",
  "method": "Find the first date of Hanukkah on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "Hanukkah starts on 25 Kislev of the Hebrew calendar and lasts eight days. Hebrew days begin at sunset, so the first candle is lit on the evening before.",
    "Start dates from January 1, 1900 to December 31, 2400 work, because the Hebrew calendar is a fixed arithmetic rule.",
    "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."
  ],
  "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 Hanukkah",
      "description": "Whole days from the start date to the next Hanukkah; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next date of Hanukkah on or after the start date.",
      "format": "date-long"
    },
    "weekday": {
      "label": "Day of the week",
      "description": "The weekday of that date.",
      "format": "text"
    },
    "weeks": {
      "label": "In weeks",
      "description": "The same number of days in weeks and days.",
      "format": "text"
    }
  },
  "defaultAnswer": {
    "inputs": {
      "from": "2026-09-30"
    },
    "outputs": {
      "days": 66,
      "date": "2026-12-05",
      "weekday": "Saturday",
      "weeks": "9 weeks and 3 days"
    },
    "text": "From September 30, 2026, there are 66 days until Hanukkah on Saturday, December 5, 2026."
  },
  "examples": [
    {
      "given": {
        "from": "2021-11-30"
      },
      "expect": {
        "date": "2022-12-19",
        "days": 384
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2022-12-20"
      },
      "expect": {
        "date": "2023-12-08",
        "days": 353
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2023-12-09"
      },
      "expect": {
        "date": "2024-12-26",
        "days": 383
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2024-12-27"
      },
      "expect": {
        "date": "2025-12-15",
        "days": 353
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2025-12-16"
      },
      "expect": {
        "date": "2026-12-05",
        "days": 354
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2026-12-06"
      },
      "expect": {
        "date": "2027-12-25",
        "days": 384
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2027-12-26"
      },
      "expect": {
        "date": "2028-12-13",
        "days": 353
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2028-12-14"
      },
      "expect": {
        "date": "2029-12-02",
        "days": 353
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2029-12-03"
      },
      "expect": {
        "date": "2030-12-21",
        "days": 383
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    },
    {
      "given": {
        "from": "2030-12-22"
      },
      "expect": {
        "date": "2031-12-10",
        "days": 353
      },
      "source": "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
    }
  ],
  "sources": [
    "Hebcal Chanukah dates (https://www.hebcal.com/holidays/chanukah); Calendrical Calculations, ch. 8"
  ],
  "related": [
    "days-until-winter",
    "days-until-christmas-eve",
    "days-until-christmas",
    "days-until-new-years-eve",
    "days-until-new-year",
    "days-until",
    "days-between-dates"
  ],
  "changelog": []
}