datetime.subsref — Index datetime elements or read their Format property.
Parentheses select datetime elements by a standard substruct-compatible path and preserve the datetime class and Format. Format member access returns text. Brace indexing and other properties are unsupported. The current implementation accepts one linear selector; native integer selectors are validated before conversion.
Syntax
out = datetime.subsref(obj, S)Inputs
obj- Type
Any- Required
- Yes
- Default
- —
- Description
- Datetime receiver object.
S- Type
Any- Required
- Yes
- Default
- —
- Description
- Standard substruct-compatible indexing path.
Returns
out- Type
Any- Description
- Indexed datetime or Format property; assignment returns the updated datetime.
Errors
RunMat:datetime:InvalidArgument- When
- Arguments or option grammar do not match supported datetime forms.
- Message
datetime: invalid argument
RunMat:datetime:InvalidInput- When
- Input values cannot be parsed, converted, or broadcast to a valid datetime result.
- Message
datetime: invalid input
RunMat:datetime:Internal- When
- Internal datetime state is invalid.
- Message
datetime: internal operation failed
Results and restrictions
Parentheses indexing produces a host datetime object with the selected shape. Format member access produces a host string. Numeric selectors may suspend for a resident payload; the datetime serial-date storage itself is host-side. Multiple indexing dimensions, braces, and unrelated members are not implemented.
Example
Select a datetime element
t = datetime([2024 1 1; 2025 6 20]); one = t(2);Using datetime.subsref with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how datetime.subsref changes the result.
Run a small datetime.subsref example, explain the result, then change one input and compare the output.
Related Datetime functions
Indexing
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
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 datetime.subsref is executed, line by line, in Rust.
- View the source for datetime.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.