Struct Instant 

pub struct Instant<S: TimeScale> { /* private fields */ }

Instant on one time scale, nanosecond resolution.

Comparison and subtraction only within one scale (see the module docs). Stored as seconds and nanoseconds since the scale’s 1970-01-01T00:00:00: range far beyond any calendar, and any i64 of Unix nanoseconds fits.

Implementations

impl<S: TimeScale> Instant<S>

pub const UNIX_EPOCH: Self

1970-01-01T00:00:00 on this scale.

pub fn new(seconds: i64, nanos: u32) -> Result<Self>

Instant from whole seconds and nanoseconds within the second.

Errors

KernelError::OutOfRange if nanos ≥ 1 s.

pub const fn from_unix_seconds(seconds: i64) -> Self

Instant a whole number of seconds from the epoch.

pub const fn from_unix_nanos(nanos: i64) -> Self

Instant nanos from the epoch (negative before it). Every i64 is representable.

pub const fn seconds(self) -> i64

Whole seconds since the epoch, floored.

pub const fn subsec_nanos(self) -> u32

Nanoseconds past the whole second, 0..1_000_000_000.

pub const fn checked_unix_nanos(self) -> Option<i64>

Nanoseconds since the epoch, if within ~292 years (the i64 range).

pub fn checked_add(self, duration: Duration) -> Option<Self>

self + duration; None on overflow.

pub fn checked_sub(self, duration: Duration) -> Option<Self>

self − duration; None on underflow.

pub fn saturating_add(self, duration: Duration) -> Self

self + duration, saturating.

pub fn saturating_sub(self, duration: Duration) -> Self

self − duration, saturating.

pub fn checked_duration_since(self, earlier: Self) -> Option<Duration>

Duration since earlier; None unless self ≥ earlier.

pub fn duration_since(self, earlier: Self) -> Result<Duration>

Duration since earlier.

Errors

KernelError::TimeReversed if earlier is later (clock stepped back or arguments swapped), with the amount.

pub fn from_civil(civil: Civil) -> Result<Self>

Instant for a calendar reading on this scale.

Errors

KernelError::OutOfRange for an invalid month, day, hour, minute, second or nanosecond. Second 60 (leap second) is rejected: the count has no place for it; the parser decides which side of the step it belongs to.

pub fn civil(self) -> Civil

Calendar reading on this instant’s own scale.

Trait Implementations

impl<S: Clone + TimeScale> Clone for Instant<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: Copy + TimeScale> Copy for Instant<S>

impl<S: TimeScale> Debug for Instant<S>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: TimeScale> Display for Instant<S>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats as 2026-09-11T10:15:30.250 UTC (ISO 8601 plus scale). Precision: decimals of the second, default 3, max 9.

impl<S: Eq + TimeScale> Eq for Instant<S>

impl<S: Hash + TimeScale> Hash for Instant<S>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<S: Ord + TimeScale> Ord for Instant<S>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl<S: PartialEq + TimeScale> PartialEq for Instant<S>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<S: PartialOrd + TimeScale> PartialOrd for Instant<S>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<S: PartialEq + TimeScale> StructuralPartialEq for Instant<S>