Struct Time 

pub struct Time(/* private fields */);

A signed time point or duration, stored as integer flicks.

Comparisons and frame conversion use integers. Floating-point seconds are intended for animation mathematics, not interval membership checks. Arithmetic panics on overflow, independently of the build profile.

Implementations

impl Time

pub const ZERO: Self

The time origin and an empty duration.

pub const fn from_ticks(ticks: i64) -> Self

Constructs time without losing integer tick precision.

pub fn from_seconds(seconds: f64) -> Self

Rounds seconds to the nearest tick; halfway cases round away from zero.

Panics

Panics for nonfinite input or a rounded result outside the signed range.

pub fn from_frame(frame: i64, rate: FrameRate) -> Self

Returns the first tick at or after the exact rational frame boundary.

Common integer and NTSC rates have exact tick boundaries. Other rates round toward positive infinity by less than one tick, including before zero. Compute each boundary directly; multiplying a rounded frame duration would accumulate drift. Frame indices round-trip through Self::to_frame when the rate does not exceed one frame per tick.

Panics

Panics if the boundary cannot be represented as signed ticks.

pub fn checked_from_frame(frame: i64, rate: FrameRate) -> Option<Self>

Converts a frame boundary with the same ceiling rule as from_frame. Returns None instead of panicking when signed ticks would overflow.

pub fn to_frame(self, rate: FrameRate) -> i64

Returns the containing frame, rounding toward negative infinity.

Panics

Panics if the frame index is outside the signed 64-bit range.

pub fn checked_to_frame(self, rate: FrameRate) -> Option<i64>

Finds the containing frame using integer floor division. Returns None instead of panicking when the frame index would overflow.

pub fn as_seconds(self) -> f64

Converts to floating-point seconds for animation mathematics.

pub const fn ticks(self) -> i64

Returns the exact signed tick count.

pub fn checked_mul(self, factor: i64) -> Option<Self>

Multiplies ticks exactly, returning None on signed overflow.

Trait Implementations

impl Add for Time

type Output = Time

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Time

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl Clone for Time

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Time

impl Debug for Time

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

Formats the value using the given formatter.

impl Default for Time

fn default() -> Self

Returns the “default value” for a type.

impl Div for Time

fn div(self, duration: Self) -> f64

Returns a dimensionless ratio; a zero duration is rejected.

type Output = f64

The resulting type after applying the / operator.

impl Div<f64> for Time

fn div(self, divisor: f64) -> Self

Divides time; a nonfinite or zero divisor is rejected.

type Output = Time

The resulting type after applying the / operator.

impl Eq for Time

impl Hash for Time

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 Mul<Time> for i32

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<Time> for i64

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<Time> for u32

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<Time> for u64

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<Time> for usize

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<Time> for f64

type Output = Time

The resulting type after applying the * operator.

fn mul(self, time: Time) -> Time

Performs the * operation.

impl Mul<f64> for Time

fn mul(self, factor: f64) -> Self

Scales time and rounds to the nearest tick, away from zero at ties.

type Output = Time

The resulting type after applying the * operator.

impl Mul<i32> for Time

type Output = Time

The resulting type after applying the * operator.

fn mul(self, factor: i32) -> Time

Performs the * operation.

impl Mul<i64> for Time

type Output = Time

The resulting type after applying the * operator.

fn mul(self, factor: i64) -> Time

Performs the * operation.

impl Mul<u32> for Time

type Output = Time

The resulting type after applying the * operator.

fn mul(self, factor: u32) -> Time

Performs the * operation.

impl Mul<u64> for Time

type Output = Time

The resulting type after applying the * operator.

fn mul(self, factor: u64) -> Time

Performs the * operation.

impl Mul<usize> for Time

type Output = Time

The resulting type after applying the * operator.

fn mul(self, factor: usize) -> Time

Performs the * operation.

impl Neg for Time

type Output = Time

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl Ord for Time

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 PartialEq for Time

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Time

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 StructuralPartialEq for Time

impl Sub for Time

type Output = Time

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Time

fn sub_assign(&mut self, other: Self)

Performs the -= operation.