Struct time::Tm

#[repr(C)]
pub struct Tm {
    pub tm_sec: i32,
    pub tm_min: i32,
    pub tm_hour: i32,
    pub tm_mday: i32,
    pub tm_mon: i32,
    pub tm_year: i32,
    pub tm_wday: i32,
    pub tm_yday: i32,
    pub tm_isdst: i32,
    pub tm_utcoff: i32,
    pub tm_nsec: i32,
}

Holds a calendar date and time broken down into its components (year, month, day, and so on), also called a broken-down time value.

Fields

tm_sec: i32

Seconds after the minute - [0, 60]

tm_min: i32

Minutes after the hour - [0, 59]

tm_hour: i32

Hours after midnight - [0, 23]

tm_mday: i32

Day of the month - [1, 31]

tm_mon: i32

Months since January - [0, 11]

tm_year: i32

Years since 1900

tm_wday: i32

Days since Sunday - [0, 6]. 0 = Sunday, 1 = Monday, ..., 6 = Saturday.

tm_yday: i32

Days since January 1 - [0, 365]

tm_isdst: i32

Daylight Saving Time flag.

This value is positive if Daylight Saving Time is in effect, zero if Daylight Saving Time is not in effect, and negative if this information is not available.

tm_utcoff: i32

Identifies the time zone that was used to compute this broken-down time value, including any adjustment for Daylight Saving Time. This is the number of seconds east of UTC. For example, for U.S. Pacific Daylight Time, the value is -7*60*60 = -25200.

tm_nsec: i32

Nanoseconds after the second - [0, 10⁹ - 1]

Methods

impl Tm

pub fn to_timespec(&self) -> Timespec

Convert time to the seconds from January 1, 1970

pub fn to_local(&self) -> Tm

Convert time to the local timezone

pub fn to_utc(&self) -> Tm

Convert time to the UTC

pub fn ctime(&self) -> TmFmt

Returns a TmFmt that outputs according to the asctime format in ISO C, in the local timezone.

Example: "Thu Jan 1 00:00:00 1970"

pub fn asctime(&self) -> TmFmt

Returns a TmFmt that outputs according to the asctime format in ISO C.

Example: "Thu Jan 1 00:00:00 1970"

pub fn strftime<'a>(&'a self, format: &'a str) -> Result<TmFmt<'a>, ParseError>

Formats the time according to the format string.

pub fn rfc822(&self) -> TmFmt

Returns a TmFmt that outputs according to RFC 822.

local: "Thu, 22 Mar 2012 07:53:18 PST" utc: "Thu, 22 Mar 2012 14:53:18 GMT"

pub fn rfc822z(&self) -> TmFmt

Returns a TmFmt that outputs according to RFC 822 with Zulu time.

local: "Thu, 22 Mar 2012 07:53:18 -0700" utc: "Thu, 22 Mar 2012 14:53:18 -0000"

pub fn rfc3339<'a>(&'a self) -> TmFmt

Returns a TmFmt that outputs according to RFC 3339. RFC 3339 is compatible with ISO 8601.

local: "2012-02-22T07:53:18-07:00" utc: "2012-02-22T14:53:18Z"

Trait Implementations

impl Add<Duration> for Tm

type Output = Tm

The resulting type after applying the + operator.

fn add(self, other: Duration) -> Tm

The resulting Tm is in UTC.

impl Clone for Tm

fn clone(&self) -> Tm

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Tm

impl Debug for Tm

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

Formats the value using the given formatter.

impl Eq for Tm

impl Hash for Tm

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, 

Feeds a slice of this type into the given [Hasher].

impl Ord for Tm

fn cmp(&self, other: &Tm) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use] fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use] fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use] fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Tm> for Tm

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<Tm> for Tm

fn partial_cmp(&self, other: &Tm) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use] fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use] fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use] fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use] fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for Tm

impl StructuralPartialEq for Tm

impl Sub<Duration> for Tm

type Output = Tm

The resulting type after applying the - operator.

fn sub(self, other: Duration) -> Tm

The resulting Tm is in UTC.

impl Sub<Tm> for Tm

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, other: Tm) -> Duration

Performs the - operation.