seconds — Create fixed durations from seconds or extract seconds from a duration.
seconds(X) creates a host duration from real numeric or logical X. For duration input it returns double seconds counts. Array shape is retained in either direction.
Syntax
out = seconds(X)Inputs
X- Type
Any- Required
- Yes
- Default
- —
- Description
- Real numeric/logical array to construct a duration, or duration array to extract fixed-unit counts.
Returns
out- Type
Any- Description
- Host duration for numeric/logical input; double counts for duration input.
Errors
RunMat:duration:InvalidArgument- When
- An input is not a supported real numeric, logical, or duration value, or a constructor form is invalid.
- Message
duration: invalid argument
RunMat:duration:InvalidObject- When
- A duration receiver has invalid or missing internal day storage.
- Message
duration: invalid object
RunMat:duration:OutOfRange- When
- A finite unit conversion exceeds the supported day-count range.
- Message
duration: value out of range
RunMat:duration:Internal- When
- A validated duration result cannot be assembled.
- Message
duration: internal operation failed
Values and conversion
Numeric classes enter binary64 day-count storage at construction. NaN and positive or negative infinity remain nonfinite durations; finite overflow is rejected. Logical values represent zero and one. Extracting a duration returns double without changing the duration.
A year here is a fixed 365.2425-day duration, not a calendar year. Use calendarDuration and calyears for calendar-relative years.
Execution
The result is host-side and forms a fusion boundary; no unit-specific GPU kernel runs. Resident numeric input is a RunMat-only extension, admitted before owner-resolved download. The same host path is available in native and WebAssembly runtimes.
Example
Construct and extract seconds
d = seconds([1 2]); n = seconds(d);Using seconds with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how seconds changes the result.
Run a small seconds example, explain the result, then change one input and compare the output.
FAQ
Is the result stored on the GPU?⌄
No. Duration objects and extracted counts are host-side. RunMat mode can gather resident numeric input through its owning provider.
Related Datetime functions
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 · years
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
Source you can read
Every RunMat function's source is public. Read exactly how seconds is executed, line by line, in Rust.
- View the source for seconds 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.