Struct chrono::DateTime [] [src]

pub struct DateTime<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: TimeZone> DateTime<Tz>
[src]

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);

Retrieves a date component.

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

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

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

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

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

Retrieves an associated offset from UTC.

Retrieves an associated time zone.

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

Adds given Duration to the current date and time.

Returns None when it will result in overflow.

Subtracts given Duration from the current date and time.

Returns None when it will result in overflow.

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

Returns a view to the naive UTC datetime.

Returns a view to the naive local datetime.

impl DateTime<FixedOffset>
[src]

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.

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.

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: TimeZone> DateTime<Tz> where
    Tz::Offset: Display
[src]

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

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

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

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: TimeZone> Add<FixedOffset> for DateTime<Tz>
[src]

The resulting type after applying the + operator

The method for the + operator

impl<Tz: TimeZone> Sub<FixedOffset> for DateTime<Tz>
[src]

The resulting type after applying the - operator

The method for the - operator

impl<Tz: Clone + TimeZone> Clone for DateTime<Tz> where
    Tz::Offset: Clone
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl<Tz: TimeZone> Datelike for DateTime<Tz>
[src]

Returns the year number in the calendar date.

Returns the month number starting from 1. Read more

Returns the month number starting from 0. Read more

Returns the day of month starting from 1. Read more

Returns the day of month starting from 0. Read more

Returns the day of year starting from 1. Read more

Returns the day of year starting from 0. Read more

Returns the day of week.

Returns the ISO week.

Makes a new value with the year number changed. Read more

Makes a new value with the month number (starting from 1) changed. Read more

Makes a new value with the month number (starting from 0) changed. Read more

Makes a new value with the day of month (starting from 1) changed. Read more

Makes a new value with the day of month (starting from 0) changed. Read more

Makes a new value with the day of year (starting from 1) changed. Read more

Makes a new value with the day of year (starting from 0) changed. Read more

Returns the absolute year number starting from 1 with a boolean flag, which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD). Read more

Returns the number of days since January 1, 1 (Day 1) in the proleptic Gregorian calendar.

impl<Tz: TimeZone> Timelike for DateTime<Tz>
[src]

Returns the hour number from 0 to 23.

Returns the minute number from 0 to 59.

Returns the second number from 0 to 59.

Returns the number of nanoseconds since the whole non-leap second. The range from 1,000,000,000 to 1,999,999,999 represents the leap second. Read more

Makes a new value with the hour number changed. Read more

Makes a new value with the minute number changed. Read more

Makes a new value with the second number changed. Read more

Makes a new value with nanoseconds since the whole non-leap second changed. Read more

Returns the hour number from 1 to 12 with a boolean flag, which is false for AM and true for PM. Read more

Returns the number of non-leap seconds past the last midnight.

impl<Tz: TimeZone> Copy for DateTime<Tz> where
    <Tz as TimeZone>::Offset: Copy
[src]

impl<Tz: TimeZone> Send for DateTime<Tz> where
    <Tz as TimeZone>::Offset: Send
[src]

impl<Tz: TimeZone, Tz2: TimeZone> PartialEq<DateTime<Tz2>> for DateTime<Tz>
[src]

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

This method tests for !=.

impl<Tz: TimeZone> Eq for DateTime<Tz>
[src]

impl<Tz: TimeZone> PartialOrd for DateTime<Tz>
[src]

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

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

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

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

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

impl<Tz: TimeZone> Ord for DateTime<Tz>
[src]

This method returns an Ordering between self and other. Read more

impl<Tz: TimeZone> Hash for DateTime<Tz>
[src]

Feeds this value into the given [Hasher]. Read more

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

impl<Tz: TimeZone> Add<OldDuration> for DateTime<Tz>
[src]

The resulting type after applying the + operator

The method for the + operator

impl<Tz: TimeZone> Sub<OldDuration> for DateTime<Tz>
[src]

The resulting type after applying the - operator

The method for the - operator

impl<Tz: TimeZone> Debug for DateTime<Tz>
[src]

Formats the value using the given formatter.

impl<Tz: TimeZone> Display for DateTime<Tz> where
    Tz::Offset: Display
[src]

Formats the value using the given formatter. Read more

impl FromStr for DateTime<FixedOffset>
[src]

The associated error which can be returned from parsing.

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

impl FromStr for DateTime<Utc>
[src]

The associated error which can be returned from parsing.

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

impl FromStr for DateTime<Local>
[src]

The associated error which can be returned from parsing.

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

impl From<SystemTime> for DateTime<Utc>
[src]

Performs the conversion.

impl From<SystemTime> for DateTime<Local>
[src]

Performs the conversion.