busdays — Generate business dates over a calendar period.
busdays(StartDate,EndDate) generates a column of business dates. The optional bdmode chooses daily, weekly, monthly, quarterly, semiannual, or annual selection, and a fourth argument supplies holidays.
Syntax
Dates = busdays(StartDate, EndDate, bdmode, Holiday)Inputs
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.
bdmode- Type
Any- Required
- No
- Default
1 (daily)- Description
- Daily, weekly, monthly, quarterly, semiannual, or annual period.
Holiday- Type
Any- Required
- No
- Default
RunMat market calendar- Description
- Date vector of nontrading days; an empty array selects the default calendar.
Returns
Dates- Type
Any- Description
- Column vector of dates.
Period and output
The default mode is daily. Modes 1 through 6, or their frequency names, select daily through annual periods. For a nondaily period, RunMat chooses the last business date on or before the calendar period end.
A datetime start, end, or holiday argument produces datetime dates; otherwise the result contains serial date numbers. The result is a column vector, including an empty column when no business date falls in a daily range.
RunMat currently caps the calendar span at one million days and uses a computed market-holiday calendar rather than a complete exchange closure history.
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
List dates across a weekend
first = datenum(2024,1,5); last = datenum(2024,1,8);
d = busdays(first,last);Select monthly business dates
d = busdays(datenum(2024,1,1),datenum(2024,2,29),3);Using busdays with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how busdays changes the result.
Run a small busdays example, explain the result, then change one input and compare the output.
FAQ
How are custom holidays supplied?⌄
Pass bdmode as the third argument and the holiday dates as the fourth argument.
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 busdays is executed, line by line, in Rust.
- View the source for busdays 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.