Struct Timestamp 

pub struct Timestamp { /* private fields */ }

The representation for a timestamp used by the TZif implementation.

We don’t use Timestamp from the root of this crate because TZif data doesn’t require nanosecond resolution. Instead, this representation uses only second resolution. This makes for a more compact sequence of transitions, which means more data fits into cache and thus faster binary search.

Implementations

impl Timestamp

pub const MIN: Timestamp

The minimum timestamp value.

pub const MAX: Timestamp

The maximum timestamp value.

pub const UNIX_EPOCH: Timestamp

The zero value for a timestamp, which also corresponds to the Unix epoch (1970-01-01T00:00:00Z).

pub const fn new(ts: Timestamp) -> Timestamp

Creates a new TZif timestamp from jiff-core’s standard timestamp type.

Note that this completely ignores any subsecond component of the provided timestamp.

pub const fn from_second(second: i64) -> Result<Timestamp, RangeError>

Creates a new Timestamp from a Unix timestamp integer value.

This returns an error if the value is not in the legal bounds for this type.

pub const fn as_second(self) -> i64

Returns the second value of this timestamp.

It is the number of seconds since the Unix epoch (1970-01-01T00:00:00Z). Timestamps prior to the Unix epoch are negative. Timestamps are the Unix epoch are 0.

pub const fn to_datetime(self, offset: Offset) -> DateTime

Converts this timestamp to a civil datetime for the offset given.

pub const fn to_standard_timestamp(self) -> Timestamp

Converts this timestamp back to the “standard” timestamp.

Note that the timestamp returned here always has its nanosecond component set to 0.

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Timestamp

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl Hash for Timestamp

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 Timestamp

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

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Timestamp

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