# Struct chrono::datetime::DateTime [−] [src]

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

ISO 8601 combined date and time with time zone.

## Methods

### `impl<Tz: TimeZone> DateTime<Tz>`
[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.

#### `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 num_seconds_from_unix_epoch(&self) -> i64`

Deprecated: Same to `DateTime::timestamp`.

#### `fn offset<'a>(&'a self) -> &'a Tz::Offset`

Retrieves an associated offset from UTC.

#### `fn timezone(&self) -> Tz`

Retrieves an associated time zone.

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

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

#### `fn checked_add(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(self, rhs: Duration) -> Option<DateTime<Tz>>`

Subtracts given `Duration` from the current date and time.

Returns `None` when it will result in overflow.

#### `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) -> ParseResult<DateTime<FixedOffset>>`

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) -> ParseResult<DateTime<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.

#### `fn parse_from_str(s: &str, fmt: &str) -> ParseResult<DateTime<FixedOffset>>`

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]

#### `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<'a>(&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: Clone + TimeZone> Clone for DateTime<Tz> where
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

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

#### `fn year(&self) -> i32`

Returns the year number in the calendar date.

#### `fn month(&self) -> u32`

Returns the month number starting from 1. Read more

#### `fn month0(&self) -> u32`

Returns the month number starting from 0. Read more

#### `fn day(&self) -> u32`

Returns the day of month starting from 1. Read more

#### `fn day0(&self) -> u32`

Returns the day of month starting from 0. Read more

#### `fn ordinal(&self) -> u32`

Returns the day of year starting from 1. Read more

#### `fn ordinal0(&self) -> u32`

Returns the day of year starting from 0. Read more

#### `fn weekday(&self) -> Weekday`

Returns the day of week.

#### `fn isoweekdate(&self) -> (i32, u32, Weekday)`

Returns the ISO week date: an adjusted year, week number and day of week. The adjusted year may differ from that of the calendar date. Read more

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#### `fn year_ce(&self) -> (bool, u32)`

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

#### `fn num_days_from_ce(&self) -> i32`

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

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

#### `fn hour(&self) -> u32`

Returns the hour number from 0 to 23.

#### `fn minute(&self) -> u32`

Returns the minute number from 0 to 59.

#### `fn second(&self) -> u32`

Returns the second number from 0 to 59.

#### `fn nanosecond(&self) -> u32`

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

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

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

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

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

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

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

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

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

#### `fn hour12(&self) -> (bool, u32)`

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

#### `fn num_seconds_from_midnight(&self) -> u32`

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]

#### `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: TimeZone> Eq for DateTime<Tz>`
[src]

### `impl<Tz: TimeZone> PartialOrd for DateTime<Tz>`
[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: TimeZone> Ord for DateTime<Tz>`
[src]

#### `fn cmp(&self, other: &DateTime<Tz>) -> Ordering`

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

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

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

Compares and returns the maximum of two values. Read more

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

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

Compares and returns the minimum of two values. Read more

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

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

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

#### `fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,`
1.3.0

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

### `impl<Tz: TimeZone> Add<Duration> for DateTime<Tz>`
[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: TimeZone, Tz2: TimeZone> Sub<DateTime<Tz2>> for DateTime<Tz>`
[src]

#### `type Output = Duration`

The resulting type after applying the `-` operator

#### `fn sub(self, rhs: DateTime<Tz2>) -> Duration`

The method for the `-` operator

### `impl<Tz: TimeZone> Sub<Duration> for DateTime<Tz>`
[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: TimeZone> Debug for DateTime<Tz>`
[src]

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter. Read more

### `impl FromStr for DateTime<FixedOffset>`
[src]

#### `type Err = ParseError`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> ParseResult<DateTime<FixedOffset>>`

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) -> ParseResult<DateTime<UTC>>`

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) -> ParseResult<DateTime<Local>>`

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

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)