Struct livesplit_core::DateTime
[−]
[src]
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
[src]
fn from_utc(datetime: NaiveDateTime, offset: Tz::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::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>
[src]
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>
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::Offset: Display
[src]
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> Copy for DateTime<Tz> where Tz: TimeZone, Tz::Offset: Copy
[src]
impl<Tz, Tz2> PartialEq<DateTime<Tz2>> for DateTime<Tz> where Tz: TimeZone,
Tz2: TimeZone
[src]
Tz2: TimeZone
fn eq(&self, other: &DateTime<Tz2>) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0
This method tests for !=
.
impl<Tz> Ord for DateTime<Tz> where Tz: TimeZone
[src]
fn cmp(&self, other: &DateTime<Tz>) -> Ordering
This method returns an Ordering
between self
and other
. Read more
impl<Tz> Send for DateTime<Tz> where Tz: TimeZone, Tz::Offset: Send
[src]
impl Deserialize for DateTime<FixedOffset>
[src]
fn deserialize<D>(deserializer: D) -> Result<DateTime<FixedOffset>, D::Error> where D: Deserializer
impl Deserialize for DateTime<UTC>
[src]
fn deserialize<D>(deserializer: D) -> Result<DateTime<UTC>, D::Error> where D: Deserializer
impl Deserialize for DateTime<Local>
[src]
fn deserialize<D>(deserializer: D) -> Result<DateTime<Local>, D::Error> where D: Deserializer
impl<Tz> Datelike for DateTime<Tz> where Tz: TimeZone
[src]
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 isoweekdate(&self) -> (i32, u32, Weekday)
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 FromStr for DateTime<FixedOffset>
[src]
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. Read more
impl FromStr for DateTime<UTC>
[src]
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. Read more
impl FromStr for DateTime<Local>
[src]
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. Read more
impl<Tz> Eq for DateTime<Tz> where Tz: TimeZone
[src]
impl<Tz> PartialOrd<DateTime<Tz>> for DateTime<Tz> where Tz: TimeZone
[src]
fn partial_cmp(&self, other: &DateTime<Tz>) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
1.0.0
This method tests less than (for self
and other
) and is used by the <
operator. Read more
fn le(&self, other: &Rhs) -> bool
1.0.0
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
fn gt(&self, other: &Rhs) -> bool
1.0.0
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
fn ge(&self, other: &Rhs) -> bool
1.0.0
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl<Tz> Sub<FixedOffset> for DateTime<Tz> where Tz: TimeZone
[src]
type Output = DateTime<Tz>
The resulting type after applying the -
operator
fn sub(self, rhs: FixedOffset) -> DateTime<Tz>
The method for the -
operator
impl<Tz> Sub<Duration> for DateTime<Tz> where Tz: TimeZone
[src]
type Output = DateTime<Tz>
The resulting type after applying the -
operator
fn sub(self, rhs: Duration) -> DateTime<Tz>
The method for the -
operator
impl<Tz> Timelike for DateTime<Tz> where Tz: TimeZone
[src]
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> Hash for DateTime<Tz> where Tz: TimeZone
[src]
impl<Tz> Display for DateTime<Tz> where Tz: TimeZone, Tz::Offset: Display
[src]
fn fmt(&self, f: &mut Formatter) -> Result<(), Error>
Formats the value using the given formatter. Read more
impl<Tz> Debug for DateTime<Tz> where Tz: TimeZone
[src]
impl<Tz> Serialize for DateTime<Tz> where Tz: TimeZone
[src]
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: Serializer
impl<Tz> Add<FixedOffset> for DateTime<Tz> where Tz: TimeZone
[src]
type Output = DateTime<Tz>
The resulting type after applying the +
operator
fn add(self, rhs: FixedOffset) -> DateTime<Tz>
The method for the +
operator
impl<Tz> Add<Duration> for DateTime<Tz> where Tz: TimeZone
[src]
type Output = DateTime<Tz>
The resulting type after applying the +
operator
fn add(self, rhs: Duration) -> DateTime<Tz>
The method for the +
operator
impl<Tz> Clone for DateTime<Tz> where Tz: TimeZone + Clone, Tz::Offset: Clone
[src]
fn clone(&self) -> DateTime<Tz>
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more