calendar

name	calendar
description	Use whenever a strategy depends on the market calendar — market closures/holidays, trading-day counting, the Nth trading day before/after a date, or whether a date is a trading day. Use QuantConnect's built-in calendar; do not hand-roll a holiday calendar or hardcode dates.

Market calendar — use QC's built-in calendar, don't reinvent it

Don't hand-roll a trading-day loop or hardcode dates. QuantConnect exposes the real historical calendar for each security's exchange. But it does NOT hand you a clean "named holidays" list, so read this carefully — the obvious-looking APIs do something different from what their names suggest (all behaviour below is verified on the cloud).

Stepping / counting trading days — THIS is the reliable primitive

On the exchange hours object:

var hours = Securities[symbol].Exchange.Hours;
var prev = hours.GetPreviousTradingDay(d);   // -> DateTime, trading day strictly before d
var next = hours.GetNextTradingDay(d);       // -> DateTime, trading day strictly after d
var openToday = hours.IsDateOpen(d);         // -> bool, true iff the exchange trades on date d

These skip weekends and all closures, so no manual weekend/holiday checks are needed.

• "Last trading day before date H" → hours.GetPreviousTradingDay(H).
• "Nth trading day before H" → start at H and call GetPreviousTradingDay N times in a loop.
• Verified: before Memorial Day 2025 (Mon 5/26), one step → 5/23, five steps → 5/19; IsDateOpen(5/26) → false.

The session open/close TIME on a date (early-close aware)

For the actual TIME the exchange opens/closes on a date — not just whether it trades — use the exchange-hours helpers, instead of reading .EarlyCloses or hand-rolling the session segments:

var hours = Securities[symbol].Exchange.Hours;
var closeDt = hours.GetNextMarketClose(Time, false);   // next close at/after Time; extendedMarketHours: false
var openDt  = hours.GetNextMarketOpen(Time, false);

These return the REAL boundary for that date, so they already account for early-close half-days (e.g. a 13:00 close) and holidays. Use them for time-to-close logic, or to find when "the close" actually is, rather than hardcoding 16:00 or computing it from the hours segments yourself.

Full-day market closures — Exchange.Hours.Holidays

Securities[symbol].Exchange.Hours.Holidays → a HashSet<DateTime> (midnight) of EVERY full-day closure for that exchange. Compare on the date component: hours.Holidays.Any(h => h.Date == d.Date).

This is NOT a list of the named federal holidays. It is the union of ALL full-day closures, which includes:

• Good Friday (a market closure but not a federal holiday), and
• ad-hoc closures — e.g. 2025-01-09 was closed for a national day of mourning; historically also hurricanes, 9/11, etc.

So you cannot get "the nine federal holidays" by taking .Holidays and dropping Good Friday — you would still pick up the ad-hoc days. Use .Holidays / IsDateOpen to answer "is the market closed on date D," not to enumerate named holidays. Half-days are separate: .EarlyCloses / .LateOpens (dictionaries) — a half-day is not in .Holidays.

Pitfall — GetDaysByType does NOT return holidays

TradingCalendar.GetDaysByType(TradingDayType.PublicHoliday, start, end) returns ALL non-business days (weekends + closures) — ~117 for a single year, not ~10. The TradingDay.PublicHoliday flag is likewise true for weekends (a Saturday comes back with PublicHoliday=true, Weekend=true). Do not use this method, or that flag, to find holidays.

• TradingCalendar.GetTradingDays(start, end) is fine for enumerating days; identify a weekday closure as BusinessDay == false && Weekend == false (this still includes Good Friday + ad-hoc closures, same caveat as .Holidays).

When a strategy targets SPECIFIC NAMED holidays

QC's calendar can tell you whether a day is closed and can count trading days, but it cannot name a closure. If the method needs particular named holidays (e.g. the nine U.S. federal holidays, excluding Good Friday), compute each holiday's NOMINAL calendar date by its rule (a fixed date like new DateTime(y, 7, 4), or an Nth-weekday like the 3rd Monday of January; honor start years such as Juneteenth from 2022). Then ANCHOR on that nominal date and let the calendar API map it to trading days:

• "Last trading day before holiday H" → hours.GetPreviousTradingDay(nominalH). It already skips the weekend, the observed closure, and any adjacent closures, so it returns the correct day in every case.
• Do NOT hand-roll observed-date shifts (Saturday→Friday / Sunday→Monday). The generic shift is WRONG for New Year's: NYSE does not close the preceding Friday when Jan 1 is a Saturday (verified — Dec 31 2021 was a normal trading day, with IsDateOpen true and not in .Holidays), so a hand-rolled shift mis-dates the window by a day. The nominal-anchor approach is correct for all of them, New Year included, with no special cases.

Do not try to reverse-engineer names out of .Holidays.