Struct TSpan

Source

pub struct TSpan {
    pub sec: i64,
    pub attos: u64,
}

Expand description

A high-precision duration (time span) expressed as seconds + attoseconds (where 1 attosecond = 10⁻¹⁸ s).

TSpan is the time span counterpart of Dt.

Precision: 10⁻¹⁸ s
Range: ±~292 billion years (i64 seconds limit).

Fields§

§sec: i64

Signed whole seconds.

§attos: u64

Fractional part in attoseconds (0 ≤ attos < 10¹⁸).

Implementations§

Source §

pub const fn is_zero(self) -> bool

Returns true if this duration is exactly zero.

Source

pub const fn to_sec_f(self) -> Real

Converts this duration to a floating-point number of seconds. It computes sec + attos / 10¹⁸ using f64. It is lossy by design (f64 only has ~15.95 decimal digits of precision).

Source

pub const fn mul(self, rhs: i64) -> Self

Multiplies this duration by an integer scalar (exact).

Uses 128-bit arithmetic internally.

Source

pub const fn div(self, rhs: i64) -> Self

Divides this duration by an integer scalar (exact floor division).

Returns ZERO if rhs == 0. Uses floor division (toward negative infinity) for consistency with the existing floor method.

Source

pub const fn floor(self, unit: TSpan) -> TSpan

Returns the largest multiple of unit that is ≤ self. If unit is zero, returns self unchanged (exact, full precision).

Source

pub const fn ceil(self, unit: TSpan) -> TSpan

Returns the smallest multiple of unit that is ≥ self. If unit is zero, returns self unchanged (exact, full precision).

Source

pub const fn round(self, unit: TSpan) -> TSpan

Returns the nearest multiple of unit. Halfway cases round away from zero (matches old f64::round). If unit is zero, returns self unchanged (exact, full precision).

Source

pub const fn abs_div_floor(self, unit: TSpan) -> usize

Returns floor(|self| / |unit|) as usize, saturating at usize::MAX.

Fully exact integer arithmetic using 128-bit intermediaries. Used by TimeRange::len.

Source

pub const fn mul_by_f(self, rhs: Real) -> Self

Integer part of rhs is multiplied exactly (pure i128 arithmetic).
Fractional part (|frac| < 1) uses the 10¹⁵ scaling.

Source

pub const fn div_by_f(self, rhs: Real) -> Self

Divides by a real number (routes through the high-precision mul_by_f).

Source

pub const fn div_by_2(self) -> TSpan

Divides this duration by 2 (convenience wrapper).

Source

pub const fn add_1sec(&mut self)

Adds exactly 1 second to this time value using saturating arithmetic.

Source

pub const fn add_1min(&mut self)

Adds exactly 1 minute (60 seconds) to this time value using saturating arithmetic.

Source

pub const fn add_1hr(&mut self)

Adds exactly 1 hour (3600 seconds) to this time value using saturating arithmetic.

Source

pub const fn add_1ms(&mut self)

Adds exactly 1 millisecond to this time value.

This affects the subsecond component and may cause a carry into the seconds field.

Source

pub const fn add_1us(&mut self)

Adds exactly 1 microsecond to this time value.

This affects the subsecond component and may cause a carry into the seconds field.

Source

pub const fn add_1ns(&mut self)

Adds exactly 1 nanosecond to this time value.

This affects the subsecond component and may cause a carry into the seconds field.

Source

pub const fn add_sec(&mut self, n: i64)

Adds the specified number of seconds to this time value using saturating arithmetic.

Source

pub const fn add_min(&mut self, n: i64)

Adds the specified number of minutes to this time value using saturating arithmetic.

Source

pub const fn add_hr(&mut self, n: i64)

Adds the specified number of hours to this time value using saturating arithmetic.

Source