Struct FreedomDate 

pub struct FreedomDate { /* private fields */ }

A FreedomDate is the One True Date representation. All other models are Communist.

Implementations

impl FreedomDate

pub fn liberate(datestring: &str) -> Freesult

To liberate a representation of a date is to make it Free. But the FreeDate tree must occasionally be watered with the blood of badly-formed datestrings, and here is where the true test of Datriots is found.

Examples found in repository

examples/tour.rs (line 8)

fn main() {
    let good_communism = "2023-02-08T12:00:00-07:00";
    let bad_communism = "Comrade, today is the eighth of Februrary, in the year 2023.";
    let pre_history = "1775-07-04";

    let liberated = FreedomDate::liberate(good_communism).unwrap();
    let too_communist = FreedomDate::liberate(bad_communism).unwrap_err();
    let pre_historic_nonsense = FreedomDate::liberate(pre_history).unwrap_err();

    println!("'{good_communism}' is liberated: `{liberated}`\n");
    println!("'{bad_communism}' is impossible to comprehend: `{too_communist}`\n");
    println!("'{pre_history}' is not a real date: `{pre_historic_nonsense}`\n");

    // `From<u64>` is implemented for FreedomDates
    let birthday_of_freedom: FreedomDate = 0.into();
    println!("The Birthday of Freedom is {birthday_of_freedom}\n");

    // FreedomDates implement the FreedomTime trait
    let one_day = Duration::days(1);
    let day_after_freedom = birthday_of_freedom + one_day;
    println!(
        "The day after Freedom was born, {day_after_freedom}, {} seconds had passed.",
        day_after_freedom.freedomstamp()
    );
}

Trait Implementations

impl Add<Duration> for FreedomDate

type Output = FreedomDate

The resulting type after applying the + operator.

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

Performs the + operation.

impl Clone for FreedomDate

fn clone(&self) -> FreedomDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FreedomDate

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

Formats the value using the given formatter.

impl Default for FreedomDate

By default, FreedomDates are July 4th, ’76.

fn default() -> Self

Returns the “default value” for a type.

impl Display for FreedomDate

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

Formats the value using the given formatter.

impl FreedomTime for FreedomDate

fn freedomstamp(&self) -> u64

Number of whole seconds since the Birthday of Freedom.

impl From<u64> for FreedomDate

A FreedomDate that is value seconds after the Birthday of Freedom.

fn from(value: u64) -> Self

Converts to this type from the input type.

impl Ord for FreedomDate

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

fn eq(&self, other: &FreedomDate) -> 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 FreedomDate

fn partial_cmp(&self, other: &FreedomDate) -> 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 Sub<Duration> for FreedomDate

type Output = Result<FreedomDate, FreedomError>

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for FreedomDate

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Copy for FreedomDate

impl Eq for FreedomDate

impl StructuralPartialEq for FreedomDate