lbusdate — Find the last business date of a month.
lbusdate(Year,Month) returns a serial date number for the last Monday-through-Friday date not in the selected holiday set.
Syntax
Date = lbusdate(Year, Month, Holiday, Weekend, outputType)Inputs
Year- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Calendar year or array of years.
Month- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Month number or compatible array of months.
Holiday- Type
Any- Required
- No
- Default
RunMat market calendar- Description
- Date vector of nontrading days; an empty array selects the default calendar.
Weekend- Type
LogicalArray- Required
- No
- Default
[1 0 0 0 0 0 1]- Description
- Seven Sunday-first weekend indicators.
outputType- Type
StringScalar- Required
- No
- Default
datenum or Holiday's datetime class- Description
- datenum or datetime output selection.
Returns
Dates- Type
Any- Description
- Column vector of dates.
Inputs and limits
Year and Month can be scalar or compatible numeric arrays. A third argument replaces the default computed holidays; the fourth supplies a seven-element Sunday-first Weekend mask. Results preserve the broadcast input shape.
The fifth outputType argument selects datenum or datetime. Without it, a datetime Holiday argument selects datetime output; otherwise the result uses double serial dates. The default computed holiday list is not a complete historical exchange closure record.
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
Find the last June trading date
d = lbusdate(2024,6);Request a datetime result
d = lbusdate(2024,6,[],[],"datetime");Using lbusdate with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how lbusdate changes the result.
Run a small lbusdate example, explain the result, then change one input and compare the output.
FAQ
What happens if month-end is a weekend?⌄
The result moves backward to the most recent nonholiday business date.
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 lbusdate is executed, line by line, in Rust.
- View the source for lbusdate 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.