Struct time::Tm

[+] Show declaration

[+] Expand attributes
#[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,
}

[−] Expand description

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

[−] Expand description

Seconds after the minute - [0, 60]

tm_min: i32

[−] Expand description

Minutes after the hour - [0, 59]

tm_hour: i32

[−] Expand description

Hours after midnight - [0, 23]

tm_mday: i32

[−] Expand description

Day of the month - [1, 31]

tm_mon: i32

[−] Expand description

Months since January - [0, 11]

tm_year: i32

[−] Expand description

Years since 1900

tm_wday: i32

[−] Expand description

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

tm_yday: i32

[−] Expand description

Days since January 1 - [0, 365]

tm_isdst: i32

[−] Expand description

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

[−] Expand description

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

[−] Expand description

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 Copy for Tm

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 PartialEq 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 Eq for Tm

impl Debug for Tm

[+]

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

[−]

Formats the value using the given formatter.

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 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 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.

impl PartialOrd for Tm

[+]

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

[−]

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

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

[−]

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

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

[−]

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

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

[−]

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

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

[+]

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

[−]

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

[−]

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

[−]

Compares and returns the minimum of two values.