datenum — Convert supported date inputs to serial day numbers.
datenum returns double serial day numbers. It accepts datetime values, supported date text, three- or six-column date vectors, or three to six numeric components with scalar expansion. A zero-argument call reads the current local time. A numeric tensor that is not recognized as a date vector is interpreted as serial dates in the current RunMat implementation.
Syntax
DateNumber = datenum()
DateNumber = datenum(t)
DateNumber = datenum(DateVector)
DateNumber = datenum(DateString)
DateNumber = datenum(Y,M,D)
DateNumber = datenum(Y,M,D,H,MI,S)Inputs
D- Type
Any- Required
- Yes
- Default
- —
- Description
- Datetime, serial date number, or supported date text.
DateVector- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- One date per row, with three or six numeric components.
DateString- Type
Any- Required
- Yes
- Default
- —
- Description
- Supported date text in a string or character array.
Y- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Calendar year; scalar values expand to the other components' shape.
M- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Calendar month; scalar values expand to the other components' shape.
D- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Calendar day; scalar values expand to the other components' shape.
H- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Hour component.
MI- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Minute component.
S- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Second component, possibly fractional.
Returns
DateNumber- Type
NumericArray- Description
- Host double serial date values.
Date-vector and component forms
Each row of an N-by-3 or N-by-6 matrix produces one serial date. Three-component rows supply year, month, and day; six-component rows add hour, minute, and second. Non-scalar component arrays must have matching shapes; scalar components expand. A single result is a double scalar and multiple results form an array.
RunMat validates calendar dates and time components. Four- and five-component forms, logical components, and single or integer numeric input beyond the documented double forms require RunMat mode. The current date model stores instants as floating serial days, so values that require finer precision than that representation may round. Text parsing covers common ISO and day-month-name forms but not all MATLAB formatIn, PivotYear, locale, or time-zone forms.
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
Convert components to a serial date
n = datenum(2024,3,14);Convert two date-vector rows
n = datenum([2024 3 14; 2024 3 15]);Using datenum with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how datenum changes the result.
Run a small datenum example, explain the result, then change one input and compare the output.
FAQ
Does datenum account for time zones?⌄
The current RunMat datetime object has no full time-zone model. Calls without a date and relative text use the machine's local clock.
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 datenum is executed, line by line, in Rust.
- View the source for datenum 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.