Struct UnixDay

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

Days since the Unix Epoch. 1970-01-01 (Gregorian) is day zero.

Important: “Unix Day” is not a Unix timestamp! Neither in seconds nor milliseconds.

Example

use sac13::prelude::*;
use sac13::day_counts::UnixDay;

const SECONDS_PER_DAY : i32 = 86400;

// This example completely ignores time zones
// and will give you the UnixDay for the timestamp in UTC;
// which technically isn't a time zone, but I think you get the gist.
let unix_timestamp_seconds = 1355313600;
let unix_day = unix_timestamp_seconds / SECONDS_PER_DAY;

let date : Date = UnixDay::new(unix_day).unwrap().convert();

About Unix Days

The name is actually made up, but the concept is simple. It’s the number of days since the Unix Epoch, so 1.1.1970 (Gregorian) is day zero. Java calls this EPOCH_DAY but because epoch is a bit too unspecific for my taste I named it UnixDay.

Why do I have to manually convert timestamps?

It was actually a very deliberate choice to not allow construction with unix timestamps directly because if you have a timestamp, you have to think about time zones, or you will get subtle bugs. To force you to think about the conversion we let you do it manually.

Implementations

impl UnixDay

pub const MIN_INT: i32 = -4_371_872i32

Earliest representable date (in its native integer type).

pub const MAX_INT: i32 = 5_124_428i32

Latest representable value (in its native integer type).

pub const MIN: Self

Earliest representable date

pub const MAX: Self

Latest representable value

pub const fn new(value: i32) -> Option<Self>

Creates a new UnixDay.

Returns None for invalid values. Valid values are between (and including) MIN_INT (A000-01-01) and MAX_INT (Z999-13-29).

pub const fn value(&self) -> i32

Returns the underlying integer value.

pub const fn tomorrow(&self) -> Option<Self>

Returns the next day. Returns None if the next day is outside the valid SAC13 range.

pub const fn yesterday(&self) -> Option<Self>

Returns the previous day. Returns None if the previous day is outside the valid SAC13 range.

Trait Implementations

impl CalendarDate for UnixDay

const MIN: Self = Self::MIN

Earliest representable date.

const MAX: Self = Self::MAX

Latest representable date.

fn as_julian(&self) -> i32

Convert the date into the corresponding Julian Day Number.

fn from_julian(value: i32) -> Option<Self>

Get the date from the corresponding Julian

fn tomorrow(self) -> Option<Self>

fn yesterday(self) -> Option<Self>

fn convert<T: CalendarDate>(self) -> T

Converts the calendar date to a different calendar system.

impl Clone for UnixDay

fn clone(&self) -> UnixDay

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnixDay

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

Formats the value using the given formatter.

impl Display for UnixDay

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

Formats the value using the given formatter.

impl Hash for UnixDay

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 Ord for UnixDay

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

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

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

impl Eq for UnixDay

impl StructuralPartialEq for UnixDay