holidays — Return nontrading dates from RunMat's computed market calendar.
holidays(StartDate,EndDate) returns dates from the built-in calendar inside an inclusive range. In RunMat mode, a zero-argument call uses the current local calendar year.
Syntax
Dates = holidays()
Dates = holidays(Year) [RunMat mode]
Dates = holidays(StartDate, EndDate, AltHolidays)Inputs
Year- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Calendar year or array of years.
StartDate- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar or array of datetime, text, or serial dates.
EndDate- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar or compatible array of end dates.
AltHolidays- Type
Any- Required
- No
- Default
- —
- Description
- Alternate dates to return within the requested inclusive range.
Returns
Dates- Type
Any- Description
- Column vector of dates.
Calendar scope
RunMat computes ordinary market holidays from fixed and weekday rules. It does not yet carry the complete NYSE special-closure history or all rule-change dates; use an explicit holiday vector in the other business-day functions when those dates matter.
With no arguments, RunMat reads the host's local year, so its result changes with time. That local-year behavior and the single-numeric-Year convenience form are RunMat-only extensions and are rejected in MATLAB compatibility mode. MATLAB's no-argument form instead returns a full historical list, which RunMat does not yet provide.
The optional third argument selects an alternate list and filters it to the inclusive date range. A two-date numeric range returns serial date numbers; a datetime range returns a datetime column. The RunMat-only single-Year form also returns a datetime column. The computed calendar is limited to a span of 1,000 years.
Execution and placement
RunMat evaluates calendar rules on the host. The call is a fusion boundary. In RunMat compatibility mode, admitted resident operands are gathered before calculation; MATLAB compatibility mode rejects them before provider access. There is no GPU calendar kernel.
Single-precision and fixed-width integer legacy serial dates, logical values in numeric date or control positions, and resident numeric inputs are RunMat-only extensions. Logical Weekend masks remain accepted in MATLAB compatibility mode.
The calendar functions are available in the native runtime and WebAssembly. No filesystem, network, user callback, or worker service is required. The zero-argument holidays form reads the local clock.
Examples
Inspect New Year's Day
h = holidays(datenum(2024,1,1),datenum(2024,1,3));Filter an alternate holiday list
d = datenum(2024,1,15); h = holidays(datenum(2024,1,1),datenum(2024,1,31),d);Using holidays with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how holidays changes the result.
Run a small holidays example, explain the result, then change one input and compare the output.
FAQ
Can this calendar reproduce every historic exchange closure?⌄
Not yet. Supply explicit holiday dates to business-day operations for historical data requiring special closures.
Related Datetime functions
Calendar Duration
caldays · calendarDuration · calendarDuration.eq · calendarDuration.minus · calendarDuration.ne · calendarDuration.plus · calmonths · calquarters · calweeks · calyears · datetick · iscalendarduration · isdatetime
Datetime
Construction
Operators
datetime.eq · datetime.ge · datetime.gt · datetime.le · datetime.lt · datetime.minus · datetime.ne · datetime.plus
Indexing
Duration
days · duration · duration.eq · duration.ge · duration.gt · duration.le · duration.lt · duration.minus · duration.ne · duration.plus · duration.subsasgn · duration.subsref · hours · isduration · milliseconds · minutes · seconds · years
Source you can read
Every RunMat function's source is public. Read exactly how holidays is executed, line by line, in Rust.
- View the source for holidays in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.