{
  "id": "days-until-mardi-gras",
  "version": "1993f503c49f",
  "status": "published",
  "name": "Days Until Mardi Gras",
  "question": "Days until Mardi Gras",
  "summary": "Counts the days from today, or any date you choose, to the next Mardi Gras, with its date and day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-mardi-gras",
  "markdown": "https://www.acalculator.org/days/days-until-mardi-gras.md",
  "kind": "function",
  "method": "Find the first date of Mardi Gras on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "Mardi Gras (Shrove Tuesday) is 47 days before Western Easter Sunday.",
    "Start dates from January 1, 1900 to December 31, 2400 work, because the date field accepts that range.",
    "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 Mardi Gras",
      "description": "Whole days from the start date to the next Mardi Gras; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next date of Mardi Gras 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-29"
    },
    "outputs": {
      "days": 133,
      "date": "2027-02-09",
      "weekday": "Tuesday",
      "weeks": "19 weeks"
    },
    "text": "From September 29, 2026, there are 133 days until Mardi Gras on Tuesday, February 9, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2026-01-01"
      },
      "expect": {
        "date": "2026-02-17",
        "days": 47
      },
      "source": "Western (Gregorian) Easter: the Sunday after the ecclesiastical full moon, as in python-dateutil easter()"
    },
    {
      "given": {
        "from": "2026-02-18"
      },
      "expect": {
        "date": "2027-02-09",
        "days": 356
      },
      "source": "Western (Gregorian) Easter: the Sunday after the ecclesiastical full moon, as in python-dateutil easter()"
    }
  ],
  "sources": [
    "Western (Gregorian) Easter: the Sunday after the ecclesiastical full moon, as in python-dateutil easter()"
  ],
  "related": [
    "days-until-lunar-new-year",
    "days-until-st-patricks-day",
    "days-until-spring",
    "days-until-april-fools-day",
    "days-until-easter",
    "days-between-dates"
  ],
  "changelog": []
}