RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • datenum
    • datestr
    • datevec
    • eomday
    • etime
    • isbetween
    • weekday

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.
NameTypeRequiredDefaultDescription
DAnyYes—Datetime, serial date number, or supported date text.
DateVectorNumericArrayYes—One date per row, with three or six numeric components.
DateStringAnyYes—Supported date text in a string or character array.
YNumericArrayYes—Calendar year; scalar values expand to the other components' shape.
MNumericArrayYes—Calendar month; scalar values expand to the other components' shape.
DNumericArrayYes—Calendar day; scalar values expand to the other components' shape.
HNumericArrayYes—Hour component.
MINumericArrayYes—Minute component.
SNumericArrayYes—Second component, possibly fractional.

Returns

DateNumber
Type
NumericArray
Description
Host double serial date values.
NameTypeDescription
DateNumberNumericArrayHost 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

Legacy

datestr · datevec · eomday · etime · isbetween · weekday

Business Days

busdays · days252bus · daysdif · fbusdate · holidays · isbusday · lbusdate

Calendar Duration

caldays · calendarDuration · calendarDuration.eq · calendarDuration.minus · calendarDuration.ne · calendarDuration.plus · calmonths · calquarters · calweeks · calyears · datetick · iscalendarduration · isdatetime

Components

clock · day · hour · minute · month · now · second · today · year

Datetime

dateshift

Construction

datetime

Operators

datetime.eq · datetime.ge · datetime.gt · datetime.le · datetime.lt · datetime.minus · datetime.ne · datetime.plus

Indexing

datetime.subsasgn · datetime.subsref

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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Date-vector and component forms
  • Execution and placement
  • Examples
  • Convert components to a serial date
  • Convert two date-vector rows
  • Using datenum with coding agents
  • FAQ
  • Related Datetime functions
  • Legacy
  • Business Days
  • Calendar Duration
  • Components
  • Datetime
  • Construction
  • Operators
  • Indexing
  • Duration
  • Source you can read
  • About RunMat