DurationError

Classifies finite time representation and period-conversion failures.

Sn is under heavy development. This reference includes the intended 1.0 design; features may be incomplete in the current compiler. Read the status →

Module std.time

import std.time;

Public declaration contracts and authored examples. A page can document several related symbols. Implementation bodies are excluded.

pub enum DurationError

Classifies finite time representation and period-conversion failures.

These errors allocate nothing and never represent an endless wait. Generic duration constructors/adapters retain their own fallible input contracts.

DurationError.InvalidPeriod

InvalidPeriod;

A period has zero numerator or denominator.

RangeOverflow;

The selected finite representation cannot hold the result.

PrecisionLoss;

An exact conversion would discard a fractional target tick.

NonFinite;

A floating count is NaN or infinity and cannot represent finite time.

NegativeWait;

A relative native wait has a negative duration.

Documentation snapshot: October 24, 2026 About versions ↗