{
  "id": "days-until-eid",
  "version": "289d12da6bdb",
  "status": "published",
  "name": "Days Until Eid al-Fitr",
  "question": "Days until Eid al-Fitr",
  "summary": "Counts the days from today, or any date you choose, to the next Eid al-Fitr, with its date and day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-eid",
  "markdown": "https://www.acalculator.org/days/days-until-eid.md",
  "kind": "function",
  "method": "Find the first date of Eid al-Fitr on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "Eid al-Fitr is on 1 Shawwal, the day after Ramadan ends (here on the Umm al-Qura calendar).",
    "Where the month starts when the new crescent is seen, the day observed can be a day later, or rarely earlier.",
    "Start dates from January 1, 2000 to December 31, 2076 work, because the published Umm al-Qura table used here runs from 1420 AH (1999) to 1500 AH (2077).",
    "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 Eid al-Fitr",
      "description": "Whole days from the start date to the next Eid al-Fitr; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next date of Eid al-Fitr 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": 160,
      "date": "2027-03-09",
      "weekday": "Tuesday",
      "weeks": "22 weeks and 6 days"
    },
    "text": "From September 30, 2026, there are 160 days until Eid al-Fitr on Tuesday, March 9, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2019-06-05"
      },
      "expect": {
        "date": "2020-05-24",
        "days": 354
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2020-05-25"
      },
      "expect": {
        "date": "2021-05-13",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2021-05-14"
      },
      "expect": {
        "date": "2022-05-02",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2022-05-03"
      },
      "expect": {
        "date": "2023-04-21",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2023-04-22"
      },
      "expect": {
        "date": "2024-04-10",
        "days": 354
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2024-04-11"
      },
      "expect": {
        "date": "2025-03-30",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2025-03-31"
      },
      "expect": {
        "date": "2026-03-20",
        "days": 354
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2026-03-21"
      },
      "expect": {
        "date": "2027-03-09",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2027-03-10"
      },
      "expect": {
        "date": "2028-02-26",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    },
    {
      "given": {
        "from": "2028-02-27"
      },
      "expect": {
        "date": "2029-02-14",
        "days": 353
      },
      "source": "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
    }
  ],
  "sources": [
    "Umm al-Qura calendar of Saudi Arabia, month-start table 1356 to 1500 AH, as published by R. H. van Gent (https://webspace.science.uu.nl/~gent0113/islam/ummalqura.htm); principal days 1420 to 1450 AH (ummalqura_principal.htm)"
  ],
  "related": [
    "days-until-april-fools-day",
    "days-until-easter",
    "days-until-earth-day",
    "days-until-cinco-de-mayo",
    "days-until-mothers-day",
    "days-until",
    "days-between-dates"
  ],
  "changelog": []
}