{
  "id": "days-until-may-15",
  "version": "101e505863a4",
  "status": "published",
  "name": "Days Until May 15",
  "question": "Days until May 15",
  "summary": "Counts the days from today, or any date you choose, to the next May 15, with its day of the week.",
  "category": "days",
  "subcategory": "countdowns",
  "url": "https://www.acalculator.org/days/days-until-may-15",
  "markdown": "https://www.acalculator.org/days/days-until-may-15.md",
  "kind": "function",
  "method": "Find the first May 15 on or after the start date, then count the days from the start date to it.",
  "assumptions": [
    "May 15 comes every year, so the count is never more than 365 days.",
    "The start date itself is not counted: from the day before May 15, the count is 1; on May 15 itself, it is 0.",
    "Start dates from January 1, 1900 to December 31, 2400 work for the count to May 15, the range the date field accepts.",
    "Today is the date on your own device, so the count to May 15 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 15",
      "description": "Whole days from the start date to the next May 15; 0 on the day itself.",
      "format": "integer"
    },
    "date": {
      "label": "Date",
      "description": "The next May 15 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": 227,
      "date": "2027-05-15",
      "weekday": "Saturday",
      "weeks": "32 weeks and 3 days"
    },
    "text": "From September 30, 2026, there are 227 days until May 15 on Saturday, May 15, 2027."
  },
  "examples": [
    {
      "given": {
        "from": "2027-05-15"
      },
      "expect": {
        "date": "2027-05-15",
        "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-15",
        "days": 134
      },
      "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-16"
      },
      "expect": {
        "date": "2028-05-15",
        "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-14",
    "days-until-may-16",
    "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-17",
    "days-until-may-18",
    "days-until-may-19",
    "days-until-may-20",
    "days-until-may-21",
    "days-until-may-22",
    "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": []
}