DurationError

Classifies finite time representation and period-conversion failures.

Sn is under heavy development. Reference extracted from this release’s bundled standard library. Public API examples are not an exhaustive compatibility test. Read the matching release guide for tested workflows and limitations. 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.

DurationError

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.

DurationError.RangeOverflow

RangeOverflow;

The selected finite representation cannot hold the result.

DurationError.PrecisionLoss

PrecisionLoss;

An exact conversion would discard a fractional target tick.

DurationError.NonFinite

NonFinite;

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

DurationError.NegativeWait

NegativeWait;

A relative native wait has a negative duration.

Documentation snapshot: October 24, 2026 About versions ↗