datestr — Format supported dates as character rows.
datestr(D) renders supported datetime, serial-date, or date-vector input as a character array with one row per date. An optional text format or numeric format code selects the displayed calendar fields; rows are padded to equal width.
Syntax
DateString = datestr(D)
DateString = datestr(D,format)
DateString = datestr(D,formatCode)Inputs
D- Type
Any- Required
- Yes
- Default
- —
- Description
- Datetime, serial date number, or supported date text.
format- Type
StringScalar- Required
- No
- Default
- —
- Description
- Legacy date-format text (mm is month; MM is minute).
formatCode- Type
NumericScalar- Required
- Yes
- Default
- —
- Description
- Host real double scalar integer from -1 through 31; -1 selects the whole-input default.
Returns
DateString- Type
Any- Description
- One formatted character row per date.
Supported formatting
The datestr legacy format language uses lowercase mm for month and uppercase MM for minute; it differs from datetime display formats. Numeric double format codes -1 through 31 are supported. The default omits the time field only when every finite date in the input is exactly midnight; code 0 always includes it. Repeated or incompatible fields are rejected. Locale selection and PivotYear are not yet implemented. A three- or six-column numeric matrix is interpreted as date vectors; other numeric shapes are serial dates. Single-precision and integer numeric date inputs require RunMat mode.
The result is a host character array, not a string array. Its number of rows equals the number of input dates, while the width depends on the format and values.
Execution and placement
The current date implementation evaluates these operations on the host. Resident numeric input is a RunMat extension and is rejected in MATLAB mode before provider access. In RunMat mode it is gathered through its provider owner; no date GPU kernel or fused operation is used. A provider gather can suspend or fail. The returned numeric, logical, or character value is host-resident.
These functions do not read files, access the network, call user callbacks, or mutate workspace state. The relative text values now, today, tomorrow, and yesterday read the local clock; datenum() also reads it. Results from those forms depend on the machine's local time setting.
Example
Format a serial date
s = datestr(datenum(2024,3,14), 'yyyy-mm-dd');Expected output:
2024-03-14Using datestr with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how datestr changes the result.
Run a small datestr example, explain the result, then change one input and compare the output.
FAQ
Does datestr return a string array?⌄
No. It returns a character row or a padded character matrix.
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 datestr is executed, line by line, in Rust.
- View the source for datestr 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.