calquarters — Create calendar durations in quarters or extract whole quarters.
calquarters(X) creates a calendarDuration array when X is a real numeric or logical array of whole values. For calendarDuration input, it returns double whole-unit counts with the same shape. Month and day components remain separate; converting a duration to one unit does not approximate months as fixed-length days.
Syntax
C = calquarters(X)Inputs
X- Type
Any- Required
- Yes
- Default
- —
- Description
- Numeric or logical array to construct calendar units, or a calendarDuration array to extract whole units.
Returns
C- Type
Any- Description
- Calendar duration for numeric input; double whole-unit counts for calendarDuration input.
Input and result
Numeric inputs must contain finite integers; fractional units are rejected. Logical values represent zero or one. The output has the input's array shape. Extracting whole units truncates toward zero and returns double; month-based units use the stored month component, while day/week units use the stored day component.
Calendar duration objects preserve calendar-relative months separately from days. This matters at month ends and across leap years; use datetime arithmetic to resolve a duration against a particular date.
Execution and placement
Calendar units use a host calendarDuration object with separate month and day tensors. Construction and extraction run on the host; they do not launch a GPU calendar kernel and form a fusion boundary. RunMat mode can gather resident numeric input through its provider owner. MATLAB mode rejects that extension before provider access.
These functions work in native and WebAssembly runtimes. They do not use files, the network, the clock, callbacks, or workspace state. Resident gathers may suspend and fail; iscalendarduration only inspects the value class and does not gather it.
Example
Construct and extract quarters
c = calquarters([2 3]); n = calquarters(c);Using calquarters with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how calquarters changes the result.
Run a small calquarters example, explain the result, then change one input and compare the output.
FAQ
Can I construct a fractional calendar unit?⌄
No. Numeric constructor inputs must be finite whole numbers. A calendarDuration can still include fractional seconds when created from components.
Related Datetime functions
Calendar Duration
caldays · calendarDuration · calendarDuration.eq · calendarDuration.minus · calendarDuration.ne · calendarDuration.plus · calmonths · 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 calquarters is executed, line by line, in Rust.
- View the source for calquarters 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.