Struct UnixSeconds 

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

Available on crate features fmt only.

A system time represented as the number of whole seconds since the Unix epoch.

Examples:

• 0 is equal to Thu, 1 Jan 1970 00:00:00 -0000
• 951786000 is equal to Tue, 29 Feb 2000 01:00:00 -0000

UTC and time zones

The seconds are always represented in the UTC time zone.

Serialization and deserialization

UnixSeconds implements the Serialize and Deserialize traits from the serde_core crate. The system time is serialized as whole seconds. Fractional seconds are rounded down.

The serialization support is available when serde feature is enabled.

Leap seconds

This value represents the number of non-leap seconds since the Unix epoch.

Examples

Parsing and formatting

This example demonstrates how to parse Unix seconds and convert them to SystemTime.

use std::time::{Duration, SystemTime};

use tick::fmt::UnixSeconds;

let unix_seconds = "9999".parse::<UnixSeconds>()?;
assert_eq!(unix_seconds.to_string(), "9999");

let system_time: SystemTime = unix_seconds.into();
assert_eq!(
    system_time,
    SystemTime::UNIX_EPOCH + Duration::from_secs(9999)
);

Implementations

impl UnixSeconds

pub const MAX: Self

The largest value that be can represented by UnixSeconds.

This represents a Unix system time of 31 December 9999 23:59:59 UTC.

pub const UNIX_EPOCH: Self

The Unix epoch represented as UnixSeconds.

This represents a Unix system time of 1 January 1970 00:00:00 UTC.

pub fn from_secs(seconds: u64) -> Result<Self, Error>

Creates a new UnixSeconds from the given number of seconds since the Unix epoch.

Errors

Returns an error if the provided seconds are out of range.

use tick::fmt::UnixSeconds;

UnixSeconds::from_secs(u64::MAX).unwrap_err();

Examples

use std::time::{Duration, SystemTime};

use tick::fmt::UnixSeconds;

let unix_seconds = UnixSeconds::from_secs(10).unwrap();
let system_time: SystemTime = unix_seconds.into();

assert_eq!(
    system_time,
    SystemTime::UNIX_EPOCH + Duration::from_secs(10)
);

pub fn to_secs(self) -> u64

Returns the number of whole seconds since the Unix epoch.

Trait Implementations

impl Clone for UnixSeconds

fn clone(&self) -> UnixSeconds

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for UnixSeconds

impl Debug for UnixSeconds

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UnixSeconds

Available on crate features serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UnixSeconds

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

Formats the value using the given formatter.

impl Eq for UnixSeconds

impl From<Iso8601> for UnixSeconds

fn from(value: Iso8601) -> Self

Converts to this type from the input type.

impl From<Rfc2822> for UnixSeconds

fn from(value: Rfc2822) -> Self

Converts to this type from the input type.

impl From<UnixSeconds> for Iso8601

fn from(value: UnixSeconds) -> Self

Converts to this type from the input type.

impl From<UnixSeconds> for Rfc2822

fn from(value: UnixSeconds) -> Self

Converts to this type from the input type.

impl From<UnixSeconds> for SystemTime

fn from(value: UnixSeconds) -> Self

Converts to this type from the input type.

impl FromStr for UnixSeconds

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for UnixSeconds

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 UnixSeconds

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

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

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

Available on crate features serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UnixSeconds

impl ThreadAware for UnixSeconds

fn relocate(&mut self, _source: Option<Affinity>, _destination: Affinity)

Relocate this value in place to the destination affinity.

impl TryFrom<Duration> for UnixSeconds

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Duration) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<SystemTime> for UnixSeconds

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: SystemTime) -> Result<Self, Self::Error>

Performs the conversion.