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
    • clock
    • day
    • hour
    • minute
    • month
    • now
    • second
    • today
    • year

today — Read today's local date as a serial number or datetime.

today() and today('datenum') return a scalar double serial date at local midnight. today('datetime') returns that local date as a scalar datetime using the default date format. The optional outputType accepts scalar string or character text. A successful call reads the admitted calendar service once after validating the option.

Syntax

date = today()
date = today(outputType)

Inputs

outputType
Type
StringScalar
Required
Yes
Default
datenum
Description
datenum (default) or datetime; string scalar or character vector.
NameTypeRequiredDefaultDescription
outputTypeStringScalarYesdatenumdatenum (default) or datetime; string scalar or character vector.

Returns

date
Type
Any
Description
Scalar double serial date by default, or scalar datetime for outputType='datetime'; both represent local midnight.
NameTypeDescription
dateAnyScalar double serial date by default, or scalar datetime for outputType='datetime'; both represent local midnight.

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
IdentifierWhenMessage
RunMat:datetime:InvalidArgumentArguments or option grammar do not match supported datetime forms.datetime: invalid argument
RunMat:datetime:InvalidInputInput values cannot be parsed, converted, or broadcast to a valid datetime result.datetime: invalid input
RunMat:datetime:InternalInternal datetime state is invalid.datetime: internal operation failed

Clock and compatibility

Current and relative date text uses the invocation-owned calendar service. Hosted execution uses the admitted local platform calendar; deterministic deployment uses its explicit calendar policy and fails closed when unavailable.

Component numeric results are host doubles. Month and day name modes on datetime values return cell arrays of character vectors. Legacy serial/date-text forms retain their documented input-format and extension gates; this is a partial MATLAB surface.

Example

Read today's local date as a serial number or datetime.

n = today();
d = today('datenum');
t = today('datetime');

Using today with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how today changes the result.

Run a small today example, explain the result, then change one input and compare the output.

Related Datetime functions

Components

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

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

Legacy

datenum · datestr · datevec · eomday · etime · isbetween · weekday

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 today is executed, line by line, in Rust.

  • View the source for today 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
  • Errors
  • Clock and compatibility
  • Example
  • Read today's local date as a serial number or datetime.
  • Using today with coding agents
  • Related Datetime functions
  • Components
  • Business Days
  • Calendar Duration
  • Legacy
  • Datetime
  • Construction
  • Operators
  • Indexing
  • Duration
  • Source you can read
  • About RunMat