{
  "id": "days-until-ramadan",
  "version": "73eadc658a21",
  "status": "published",
  "name": "Days Until Ramadan",
  "question": "Days until Ramadan",
  "summary": "Counts the days from today, or any date you choose, to the next Ramadan, with its date and day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-ramadan",
  "markdown": "https://www.acalculator.org/days/days-until-ramadan.md",
  "kind": "function",
  "method": "Find the first date of Ramadan on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "Ramadan starts on 1 Ramadan, the first day of the ninth month of the Islamic calendar (here the Umm al-Qura calendar). Islamic days begin at sunset, so the first night prayers are on the evening before.",
    "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 Ramadan",
      "description": "Whole days from the start date to the next Ramadan; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next date of Ramadan 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": 131,
      "date": "2027-02-08",
      "weekday": "Monday",
      "weeks": "18 weeks and 5 days"
    },
    "text": "From September 30, 2026, there are 131 days until Ramadan on Monday, February 8, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2019-05-07"
      },
      "expect": {
        "date": "2020-04-24",
        "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": "2020-04-25"
      },
      "expect": {
        "date": "2021-04-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-04-14"
      },
      "expect": {
        "date": "2022-04-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-04-03"
      },
      "expect": {
        "date": "2023-03-23",
        "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": "2023-03-24"
      },
      "expect": {
        "date": "2024-03-11",
        "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": "2024-03-12"
      },
      "expect": {
        "date": "2025-03-01",
        "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": "2025-03-02"
      },
      "expect": {
        "date": "2026-02-18",
        "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": "2026-02-19"
      },
      "expect": {
        "date": "2027-02-08",
        "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": "2027-02-09"
      },
      "expect": {
        "date": "2028-01-28",
        "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-01-29"
      },
      "expect": {
        "date": "2029-01-16",
        "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-daylight-saving-time",
    "days-until-st-patricks-day",
    "days-until-spring",
    "days-until-eid",
    "days-until-april-fools-day",
    "days-until",
    "days-between-dates"
  ],
  "changelog": []
}