Struct livesplit_core::DateTime

pub struct DateTime<Tz> where
    Tz: TimeZone,  { /* fields omitted */ }

ISO 8601 combined date and time with time zone.

There are some constructors implemented here (the from_* methods), but the general-purpose constructors are all via the methods on the TimeZone implementations.

Methods

impl<Tz> DateTime<Tz> where
    Tz: TimeZone, 

fn from_utc(
    datetime: NaiveDateTime,
    offset: <Tz as TimeZone>::Offset
) -> DateTime<Tz>

Makes a new DateTime with given UTC datetime and offset. The local datetime should be constructed via the TimeZone trait.

Example

use chrono::{DateTime, TimeZone, NaiveDateTime, Utc};

let dt = DateTime::<Utc>::from_utc(NaiveDateTime::from_timestamp(61, 0), Utc);
assert_eq!(Utc.timestamp(61, 0), dt);

fn date(&self) -> Date<Tz>

Retrieves a date component.

fn time(&self) -> NaiveTime

Retrieves a time component. Unlike date, this is not associated to the time zone.

fn timestamp(&self) -> i64

Returns the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp").

fn timestamp_subsec_millis(&self) -> u32

Returns the number of milliseconds since the last second boundary

warning: in event of a leap second, this may exceed 999

note: this is not the number of milliseconds since January 1, 1970 0:00:00 UTC

fn timestamp_subsec_micros(&self) -> u32

Returns the number of microseconds since the last second boundary

warning: in event of a leap second, this may exceed 999_999

note: this is not the number of microseconds since January 1, 1970 0:00:00 UTC

fn timestamp_subsec_nanos(&self) -> u32

Returns the number of nanoseconds since the last second boundary

warning: in event of a leap second, this may exceed 999_999_999

note: this is not the number of nanoseconds since January 1, 1970 0:00:00 UTC

fn offset(&'a self) -> &'a <Tz as TimeZone>::Offset

Retrieves an associated offset from UTC.

fn timezone(&self) -> Tz

Retrieves an associated time zone.

fn with_timezone<Tz2>(&self, tz: &Tz2) -> DateTime<Tz2> where
    Tz2: TimeZone, 

Changes the associated time zone. This does not change the actual DateTime (but will change the string representation).

fn checked_add_signed(self, rhs: Duration) -> Option<DateTime<Tz>>

Adds given Duration to the current date and time.

Returns None when it will result in overflow.

fn checked_sub_signed(self, rhs: Duration) -> Option<DateTime<Tz>>

Subtracts given Duration from the current date and time.

Returns None when it will result in overflow.

fn signed_duration_since<Tz2>(self, rhs: DateTime<Tz2>) -> Duration where
    Tz2: TimeZone, 

Subtracts another DateTime from the current date and time. This does not overflow or underflow at all.

fn naive_utc(&self) -> NaiveDateTime

Returns a view to the naive UTC datetime.

fn naive_local(&self) -> NaiveDateTime

Returns a view to the naive local datetime.

impl DateTime<FixedOffset>

fn parse_from_rfc2822(s: &str) -> Result<DateTime<FixedOffset>, ParseError>

Parses an RFC 2822 date and time string such as Tue, 1 Jul 2003 10:52:37 +0200, then returns a new DateTime with a parsed FixedOffset.

fn parse_from_rfc3339(s: &str) -> Result<DateTime<FixedOffset>, ParseError>

Parses an RFC 3339 and ISO 8601 date and time string such as 1996-12-19T16:39:57-08:00, then returns a new DateTime with a parsed FixedOffset.

Why isn't this named parse_from_iso8601? That's because ISO 8601 allows some freedom over the syntax and RFC 3339 exercises that freedom to rigidly define a fixed format.

fn parse_from_str(
    s: &str,
    fmt: &str
) -> Result<DateTime<FixedOffset>, ParseError>

Parses a string with the specified format string and returns a new DateTime with a parsed FixedOffset. See the format::strftime module on the supported escape sequences.

See also Offset::datetime_from_str which gives a local DateTime on specific time zone.

impl<Tz> DateTime<Tz> where
    Tz: TimeZone,
    <Tz as TimeZone>::Offset: Display, 

fn to_rfc2822(&self) -> String

Returns an RFC 2822 date and time string such as Tue, 1 Jul 2003 10:52:37 +0200.

fn to_rfc3339(&self) -> String

Returns an RFC 3339 and ISO 8601 date and time string such as 1996-12-19T16:39:57-08:00.

fn format_with_items<'a, I>(&self, items: I) -> DelayedFormat<I> where
    I: Iterator<Item = Item<'a>> + Clone, 

Formats the combined date and time with the specified formatting items.

fn format(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>

Formats the combined date and time with the specified format string. See the format::strftime module on the supported escape sequences.

Trait Implementations

impl<Tz> Ord for DateTime<Tz> where
    Tz: TimeZone, 

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

impl<Tz> Hash for DateTime<Tz> where
    Tz: TimeZone, 

fn hash<H>(&self, state: &mut H) where
    H: Hasher, 

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<Tz> Datelike for DateTime<Tz> where
    Tz: TimeZone, 

fn year(&self) -> i32

fn month(&self) -> u32

fn month0(&self) -> u32

fn day(&self) -> u32

fn day0(&self) -> u32

fn ordinal(&self) -> u32

fn ordinal0(&self) -> u32

fn weekday(&self) -> Weekday

fn iso_week(&self) -> IsoWeek

fn with_year(&self, year: i32) -> Option<DateTime<Tz>>

fn with_month(&self, month: u32) -> Option<DateTime<Tz>>

fn with_month0(&self, month0: u32) -> Option<DateTime<Tz>>

fn with_day(&self, day: u32) -> Option<DateTime<Tz>>

fn with_day0(&self, day0: u32) -> Option<DateTime<Tz>>

fn with_ordinal(&self, ordinal: u32) -> Option<DateTime<Tz>>

fn with_ordinal0(&self, ordinal0: u32) -> Option<DateTime<Tz>>

impl<Tz> Copy for DateTime<Tz> where
    Tz: TimeZone,
    <Tz as TimeZone>::Offset: Copy, 

impl<Tz> Clone for DateTime<Tz> where
    Tz: TimeZone + Clone,
    <Tz as TimeZone>::Offset: Clone, 

fn clone(&self) -> DateTime<Tz>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Tz> Eq for DateTime<Tz> where
    Tz: TimeZone, 

impl<Tz> Serialize for DateTime<Tz> where
    Tz: TimeZone, 

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

Serialize this value into the given Serde serializer.

impl From<SystemTime> for DateTime<Utc>

fn from(t: SystemTime) -> DateTime<Utc>

Performs the conversion.

impl From<SystemTime> for DateTime<Local>

fn from(t: SystemTime) -> DateTime<Local>

Performs the conversion.

impl<Tz> Send for DateTime<Tz> where
    Tz: TimeZone,
    <Tz as TimeZone>::Offset: Send, 

impl<Tz> Add<Duration> for DateTime<Tz> where
    Tz: TimeZone, 

type Output = DateTime<Tz>

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> DateTime<Tz>

Performs the + operation.

impl<Tz> Add<FixedOffset> for DateTime<Tz> where
    Tz: TimeZone, 

type Output = DateTime<Tz>

The resulting type after applying the + operator.

fn add(self, rhs: FixedOffset) -> DateTime<Tz>

Performs the + operation.

impl<Tz, Tz2> PartialEq<DateTime<Tz2>> for DateTime<Tz> where
    Tz: TimeZone,
    Tz2: TimeZone, 

fn eq(&self, other: &DateTime<Tz2>) -> bool

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

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

This method tests for !=.

impl<'de> Deserialize<'de> for DateTime<FixedOffset>

Deserialize a value that optionally includes a timezone offset in its string representation

The serialized value can be either a string representation or a unix timestamp

fn deserialize<D>(
    deserializer: D
) -> Result<DateTime<FixedOffset>, <D as Deserializer<'de>>::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<'de> Deserialize<'de> for DateTime<Local>

Deserialize a value that includes no timezone in its string representation

The serialized value can be either a string representation or a unix timestamp

fn deserialize<D>(
    deserializer: D
) -> Result<DateTime<Local>, <D as Deserializer<'de>>::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<'de> Deserialize<'de> for DateTime<Utc>

Deserialize into a UTC value

The serialized value can be either a string representation or a unix timestamp

fn deserialize<D>(
    deserializer: D
) -> Result<DateTime<Utc>, <D as Deserializer<'de>>::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl FromStr for DateTime<Utc>

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<DateTime<Utc>, ParseError>

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

impl FromStr for DateTime<Local>

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<DateTime<Local>, ParseError>

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

impl FromStr for DateTime<FixedOffset>

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<DateTime<FixedOffset>, ParseError>

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

impl<Tz> Debug for DateTime<Tz> where
    Tz: TimeZone, 

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

Formats the value using the given formatter.

impl<Tz> Timelike for DateTime<Tz> where
    Tz: TimeZone, 

fn hour(&self) -> u32

fn minute(&self) -> u32

fn second(&self) -> u32

fn nanosecond(&self) -> u32

fn with_hour(&self, hour: u32) -> Option<DateTime<Tz>>

fn with_minute(&self, min: u32) -> Option<DateTime<Tz>>

fn with_second(&self, sec: u32) -> Option<DateTime<Tz>>

fn with_nanosecond(&self, nano: u32) -> Option<DateTime<Tz>>

impl<Tz> Display for DateTime<Tz> where
    Tz: TimeZone,
    <Tz as TimeZone>::Offset: Display, 

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

Formats the value using the given formatter.

impl<Tz> Sub<Duration> for DateTime<Tz> where
    Tz: TimeZone, 

type Output = DateTime<Tz>

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> DateTime<Tz>

Performs the - operation.

impl<Tz> Sub<FixedOffset> for DateTime<Tz> where
    Tz: TimeZone, 

type Output = DateTime<Tz>

The resulting type after applying the - operator.

fn sub(self, rhs: FixedOffset) -> DateTime<Tz>

Performs the - operation.

impl<Tz> PartialOrd<DateTime<Tz>> for DateTime<Tz> where
    Tz: TimeZone, 

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