{
  "id": "days-until-mothers-day",
  "version": "63cd8d2bdeb0",
  "status": "published",
  "name": "Days Until Mother’s Day",
  "question": "Days until Mother’s Day",
  "summary": "Counts the days from today, or any date you choose, to the next Mother’s Day, with its date and day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-mothers-day",
  "markdown": "https://www.acalculator.org/days/days-until-mothers-day.md",
  "kind": "function",
  "method": "Find the first date of Mother’s Day on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "US Mother’s Day is the second Sunday of May (36 U.S.C. 117).",
    "Start dates from January 1, 1914 to December 31, 2400 work, because Mother’s Day was first proclaimed in 1914.",
    "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 Mother’s Day",
      "description": "Whole days from the start date to the next Mother’s Day; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next date of Mother’s Day 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": 222,
      "date": "2027-05-09",
      "weekday": "Sunday",
      "weeks": "31 weeks and 5 days"
    },
    "text": "From September 29, 2026, there are 222 days until Mother’s Day on Sunday, May 9, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2026-01-01"
      },
      "expect": {
        "date": "2026-05-10",
        "days": 129
      },
      "source": "36 U.S.C. 117; the rule written again in Python 3 (datetime); docs/progress/WP-43.md"
    },
    {
      "given": {
        "from": "2026-05-11"
      },
      "expect": {
        "date": "2027-05-09",
        "days": 363
      },
      "source": "36 U.S.C. 117; the rule written again in Python 3 (datetime); docs/progress/WP-43.md"
    }
  ],
  "sources": [
    "36 U.S.C. 117; the rule written again in Python 3 (datetime); docs/progress/WP-43.md"
  ],
  "related": [
    "days-until-memorial-day",
    "days-until-summer",
    "days-until-fathers-day",
    "days-until-fourth-of-july",
    "days-until-labor-day",
    "days-between-dates"
  ],
  "changelog": []
}