duration.subsref — Index a duration array or read its Format property.
Parentheses indexing reads duration elements using the standard typed indexing path and preserves the duration class; member access reads Format. Brace indexing is unsupported. Index arrays are validated in their native class before any conversion.
Syntax
out = duration.subsref(obj, S)Inputs
obj- Type
Any- Required
- Yes
- Default
- —
- Description
- Duration receiver.
S- Type
Any- Required
- Yes
- Default
- —
- Description
- Standard substruct-compatible index path.
Returns
out- Type
Any- Description
- Indexed duration or Format property; assignment returns the updated duration.
Errors
RunMat:duration:InvalidArgument- When
- An input is not a supported real numeric, logical, or duration value, or a constructor form is invalid.
- Message
duration: invalid argument
RunMat:duration:InvalidIndex- When
- A duration index path or member selector is unsupported.
- Message
duration: invalid index
RunMat:duration:InvalidObject- When
- A duration receiver has invalid or missing internal day storage.
- Message
duration: invalid object
RunMat:duration:Internal- When
- A validated duration result cannot be assembled.
- Message
duration: internal operation failed
Results and placement
The result of parentheses indexing is a host duration with the selected shape and the original Format. Accessing Format returns text. The selector may suspend if its numeric payload is resident, and compatibility admission precedes provider download; the duration payload itself is host-side.
Example
Read one elapsed value
d = hours([2 3]); one = d(2);Using duration.subsref with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how duration.subsref changes the result.
Run a small duration.subsref example, explain the result, then change one input and compare the output.
Related Datetime functions
Duration
days · duration · duration.eq · duration.ge · duration.gt · duration.le · duration.lt · duration.minus · duration.ne · duration.plus · duration.subsasgn · hours · isduration · milliseconds · minutes · seconds · years
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
Source you can read
Every RunMat function's source is public. Read exactly how duration.subsref is executed, line by line, in Rust.
- View the source for duration.subsref 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.