ExtTime

ext_time

Trait ExtTime 

Source 
pub trait ExtTime {

Show 16 methods    // Required methods
    fn to_shorten(&self) -> String;
    fn from_str(time_str: &str) -> Result<Time, TimeError>;
    fn sub_ext(&self, right: Time) -> Duration;
    fn reset_minute(&self) -> Result<Time, TimeError>;
    fn is_same_minute(&self, other: &Time) -> bool;
    fn is_between(&self, start: Time, end: Time) -> bool;
    fn add_minutes(&self, minutes: i64) -> Time;
    fn from_seconds(seconds: i64) -> Result<Time, TimeError>;
    fn to_seconds(&self) -> i64;
    fn align_to(&self, interval: i64) -> Result<Time, TimeError>;
    fn next_day(&self) -> Time;
    fn next_hour(&self) -> Time;
    fn next_minute(&self) -> Time;
    fn next_second(&self) -> Time;
    fn to_hour_seconds(&self) -> i64;
    fn to_minute_seconds(&self) -> i64;

}
Expand description

Extension trait for Time struct providing additional utility methods

Required Methods§

Source

fn to_shorten(&self) -> String

Format time as HH:MM, padding minutes with zero if needed

§Example
use time::macros::time;
use ext_time::ExtTime;

let t = time!(9:05);
assert_eq!(t.to_shorten(), "9:05");
Source

fn from_str(time_str: &str) -> Result<Time, TimeError>

Parse time string in HH:MM format

§Arguments
  • time_str - Time string in “HH:MM” format
§Returns
  • Ok(Time) - Parsed time
  • Err - If parsing fails
Source

fn sub_ext(&self, right: Time) -> Duration

Calculate duration between two times, handling cross-day scenarios

§Arguments
  • right - The time to subtract from self
§Returns

Duration between times, always positive by adding 24 hours if needed

Source

fn reset_minute(&self) -> Result<Time, TimeError>

Reset seconds to zero, keeping hours and minutes

Source

fn is_same_minute(&self, other: &Time) -> bool

Check if two times are in the same minute

Source

fn is_between(&self, start: Time, end: Time) -> bool

Check if time is between start and end (inclusive) Handles cross-day ranges (e.g., 23:00 to 01:00)

Source

fn add_minutes(&self, minutes: i64) -> Time

Add minutes to time, wrapping around midnight if needed

Source

fn from_seconds(seconds: i64) -> Result<Time, TimeError>

Convert seconds (hours + minutes + seconds) to Time

§Arguments
  • seconds - Total seconds (hours * 3600 + minutes * 60 + seconds)
§Returns
  • Ok(Time) - Converted time
  • Err - If seconds value is invalid
Source

fn to_seconds(&self) -> i64

Convert Time to seconds (hours + minutes + seconds)

§Returns

Total seconds (hours * 3600 + minutes * 60 + seconds)

Source

fn align_to(&self, interval: i64) -> Result<Time, TimeError>

Align time to the nearest interval

§Arguments
  • interval - Interval in seconds (can be negative for backward alignment)
§Returns
  • Ok(Time) - Aligned time
  • Err(Error) - If interval is 0
Source

fn next_day(&self) -> Time

Get next day at the same time

Source

fn next_hour(&self) -> Time

Get next hour at the same minute and second

Source

fn next_minute(&self) -> Time

Get next minute at the same second

Source

fn next_second(&self) -> Time

Get next second

Source

fn to_hour_seconds(&self) -> i64

Convert time to seconds, ignoring minutes and seconds

§Returns

Total seconds of hours (hours * 3600)

Note: Returns i64 to support time differences and negative values

Source

fn to_minute_seconds(&self) -> i64

Convert time to seconds, ignoring seconds

§Returns

Total seconds of hours and minutes (hours * 3600 + minutes * 60)

Note: Returns i64 to support time differences and negative values

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§