Enum Resolution

pub enum Resolution {
    Day,
    AmPm,
    TimeOfDay,
    ThreeHour,
    Hour,
    ThirtyMinute,
    FifteenMinute,
    FiveMinute,
    Minute,
    ThirtySecond,
    FifteenSecond,
    FiveSecond,
    Second,
    FiveHundredMilli,
    HundredMilli,
    FiftyMilli,
    TenMilli,
    FiveMilli,
    Millisecond,
}

There are 19 resolutions available:

• milli, 5ms, 10ms, 50ms, 100ms, 500ms
• second, 5s, 15s, 30s
• minute, 5m, 15m, 30m
• hour, 3h, 6h, 12h (am/pm)
• whole day

The Ord impl follows natural-language: x < y means that x is lower-resolution than y.

How were these chosen?

The rule is that, for any pair of resolutions, one must be an exact integer multiple of the other. So this means, for example that “10m” and “15m” are incompatible resolutions. You can choose to allow one, or the other, but not both. (I picked 15m.)

FYI you can see this integer multiple by dividing one resolution by another:

assert_eq!(Resolution::ThirtySecond / Resolution::FiftyMilli, 600);

Variants

Day

AmPm

TimeOfDay

ThreeHour

Hour

ThirtyMinute

FifteenMinute

FiveMinute

Minute

ThirtySecond

FifteenSecond

FiveSecond

Second

FiveHundredMilli

HundredMilli

FiftyMilli

TenMilli

FiveMilli

Millisecond

Implementations

impl Resolution

pub const fn width(self) -> Duration

impl Resolution

pub fn coarser(self) -> Option<Self>

pub fn finer(self) -> Option<Self>

Trait Implementations

impl Clone for Resolution

fn clone(&self) -> Resolution

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Resolution

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

Formats the value using the given formatter.

impl Display for Resolution

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

Formats the value using the given formatter.

impl Div for Resolution

type Output = u32

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl From<Resolution> for Duration

fn from(value: Resolution) -> Self

Converts to this type from the input type.

impl Linearize for Resolution

const LENGTH: usize = 19usize

The cardinality of this type.

type Storage<__T> = [__T; 19]

[T; Self::LENGTH]

type CopyStorage<__T> = [__T; 19] where __T: Copy

[T; Self::LENGTH]

fn linearize(&self) -> usize

Maps this value to the natural numbers.

unsafe fn from_linear_unchecked(linear: usize) -> Self

The inverse of the linearize function.

impl Ord for Resolution

fn cmp(&self, other: &Resolution) -> 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.

impl PartialEq for Resolution

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Resolution

fn partial_cmp(&self, other: &Resolution) -> 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 Copy for Resolution

impl Eq for Resolution

impl StructuralPartialEq for Resolution