Struct Watch 

pub struct Watch {
    pub start: i64,
    pub offset: i64,
    pub meridiem: bool,
}

A struct that represents a watch which keeps track of the start time, offset, and meridiem. Can be addded and subtracted with i64 and &str. i64 will be treated as seconds and &str will be treated as a time string (e.g. “01:23:45”). The default display format is HH:MM:SS and +/- days.

Note on i64

Using i64 to represent time in seconds has a maximum time span of several hundred billion years. This is more than enough for most use cases. There is a few microseconds added to computation time and doubling of memory usage compared to using i32. However, the tradeoff is worth it in my opinion as i32 has a max of around 68 years.

Fields

start: i64

the starting time of the watch. This won’t change over the course of the program

offset: i64

the offset of the watch or the time span that will be added to the start time

meridiem: bool

whether the watch is in 12h or 24h format (true for 12h)

Implementations

impl Watch

pub fn new(time: &str, meridiem: bool) -> Self

create a new watch with the given time and meridiem option

pub fn str_to_secs(time: &str, is_time_span: bool) -> i64

take a time string (e.g. “01:23:45 AM”) and return the number of seconds

pub fn secs_to_mil(secs: i64) -> String

convert secs to string (HH:MM:SS format)

pub fn secs_to_mer(secs: i64) -> String

convert secs to string (12h format)

pub fn diff_to_days(diff: i64) -> String

convert diff seconds to num of days later or before

pub fn add_offset(&self) -> i64

return the end time of the watch

pub fn change_meridiem(&mut self, meridiem: bool)

change the meridiem option

Trait Implementations

impl Add<&str> for Watch

type Output = Watch

The resulting type after applying the + operator.

fn add(self, rhs: &str) -> Self::Output

Performs the + operation.

impl Add<i64> for Watch

type Output = Watch

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> Self::Output

Performs the + operation.

impl<T: AddableToWatch + Copy> AddAssign<T> for Watch

where Watch: Add<T, Output = Watch>,

fn add_assign(&mut self, other: T)

Performs the += operation.

impl Clone for Watch

fn clone(&self) -> Watch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Watch

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

Formats the value using the given formatter.

impl Default for Watch

fn default() -> Watch

Returns the “default value” for a type.

impl Display for Watch

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

Formats the value using the given formatter.

impl Sub<&str> for Watch

type Output = Watch

The resulting type after applying the - operator.

fn sub(self, rhs: &str) -> Self::Output

Performs the - operation.

impl Sub<i64> for Watch

type Output = Watch

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> Self::Output

Performs the - operation.

impl<T: AddableToWatch + Copy> SubAssign<T> for Watch

where Watch: Sub<T, Output = Watch>,

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl Copy for Watch