datevec — Return six calendar components for each date.
v = datevec(D) returns an N-by-6 double matrix with year, month, day, hour, minute, and second in each row. Requested outputs [Y,M,D,H,MI,S] split those columns into matching N-by-1 values; with one requested output, the complete six-column matrix is returned.
Syntax
DateVector = datevec(D)
[Y,M,D,H,MI,S] = datevec(D)Inputs
D- Type
Any- Required
- Yes
- Default
- —
- Description
- Datetime, serial date number, or supported date text.
Returns
DateVector- Type
NumericArray- Description
- An N-by-6 double matrix, one date per row.
Y- Type
NumericArray- Description
- Year column.
M- Type
NumericArray- Description
- Month column.
D- Type
NumericArray- Description
- Day column.
H- Type
NumericArray- Description
- Hour column.
MI- Type
NumericArray- Description
- Minute column.
S- Type
NumericArray- Description
- Second column, possibly fractional.
Returned values from datevec depend on how many outputs the caller requests.
Inputs and result
RunMat accepts numeric serial dates, datetime objects, and supported date text. Numeric arrays are flattened into one date vector per element. Single-precision and integer serial input require RunMat mode. Component seconds may contain a fractional value. More than six outputs are not supported.
The host datetime object stores serial values internally; static analysis cannot recover its hidden array size merely from the scalar object wrapper. Inference leaves row count dynamic unless the input's numeric or text shape proves it.
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.
Examples
Return a complete date vector
n = datenum(2024,3,14); v = datevec(n);Request the year and month separately
n = datenum(2024,3,14); [Y,M] = datevec(n);Using datevec with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how datevec changes the result.
Run a small datevec example, explain the result, then change one input and compare the output.
FAQ
Why does one output differ from two outputs?⌄
One output is the complete N-by-6 matrix. Two or more outputs select individual columns.
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 datevec is executed, line by line, in Rust.
- View the source for datevec 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.