{
  "id": "days-until-may-21",
  "version": "942f6b9279a1",
  "status": "published",
  "name": "Days Until May 21",
  "question": "Days until May 21",
  "summary": "Counts the days from today, or any date you choose, to the next May 21, with its day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-may-21",
  "markdown": "https://www.acalculator.org/days/days-until-may-21.md",
  "kind": "function",
  "method": "Find the first May 21 on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "May 21 comes every year, so the count is never more than 365 days.",
    "The start date itself is not counted: from the day before May 21, the count is 1; on May 21 itself, it is 0.",
    "Start dates from January 1, 1900 to December 31, 2400 work for the count to May 21, the range the date field accepts.",
    "Today is the date on your own device, so the count to May 21 changes at midnight where you are. Dates are whole calendar days, so 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 May 21",
      "description": "Whole days from the start date to the next May 21; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next May 21 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": 233,
      "date": "2027-05-21",
      "weekday": "Friday",
      "weeks": "33 weeks and 2 days"
    },
    "text": "From September 30, 2026, there are 233 days until May 21 on Friday, May 21, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2027-05-21"
      },
      "expect": {
        "date": "2027-05-21",
        "days": 0
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime (docs/progress/WP-44/truth.py)"
    },
    {
      "given": {
        "from": "2027-01-01"
      },
      "expect": {
        "date": "2027-05-21",
        "days": 140
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime (docs/progress/WP-44/truth.py)"
    },
    {
      "given": {
        "from": "2027-05-22"
      },
      "expect": {
        "date": "2028-05-21",
        "days": 365
      },
      "source": "U.S. Naval Observatory, Leap Years: the Gregorian leap year rule (https://aa.usno.navy.mil/faq/leap_years); Python 3 datetime (docs/progress/WP-44/truth.py)"
    }
  ],
  "sources": [
    "5 U.S.C. 6103 (federal holidays; weekend rule in 6103(b) and Executive Order 11582). Checked against OPM holiday schedules.",
    "Equinoxes and solstices: Jean Meeus, Astronomical Algorithms (2nd ed., 1998), chapter 27, checked against the US Naval Observatory."
  ],
  "related": [
    "days-until-may-20",
    "days-until-may-22",
    "days-until-may-1",
    "days-until-may-2",
    "days-until-may-3",
    "days-until-may-4",
    "days-until-may-5",
    "days-until-may-6",
    "days-until-may-7",
    "days-until-may-8",
    "days-until-may-9",
    "days-until-may-10",
    "days-until-may-11",
    "days-until-may-12",
    "days-until-may-13",
    "days-until-may-14",
    "days-until-may-15",
    "days-until-may-16",
    "days-until-may-17",
    "days-until-may-18",
    "days-until-may-19",
    "days-until-may-23",
    "days-until-may-24",
    "days-until-may-25",
    "days-until-may-26",
    "days-until-may-27",
    "days-until-may-28",
    "days-until-may-29",
    "days-until-may-30",
    "days-until-may-31",
    "days-between-dates"
  ],
  "changelog": []
}