# Struct chrono::offset::utc::UTC [−] [src]

    pub struct UTC;

The UTC time zone. This is the most efficient time zone when you don't need the local time. It is also used as an offset (which is also a dummy type).

## Methods

### `impl UTC`
[src]

#### `fn today() -> Date<UTC>`

Returns a `Date` which corresponds to the current date.

#### `fn now() -> DateTime<UTC>`

Returns a `DateTime` which corresponds to the current date.

## Trait Implementations

### `impl Copy for UTC`
[src]

### `impl Clone for UTC`
[src]

#### `fn clone(&self) -> UTC`

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 PartialEq for UTC`
[src]

#### `fn eq(&self, __arg_0: &UTC) -> 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 Eq for UTC`
[src]

### `impl TimeZone for UTC`
[src]

#### `type Offset = UTC`

An associated offset type. This type is used to store the actual offset in date and time types. The original `TimeZone` value can be recovered via `TimeZone::from_offset`. Read more

#### `fn from_offset(_state: &UTC) -> UTC`

Reconstructs the time zone from the offset.

#### `fn offset_from_local_date(&self, _local: &NaiveDate) -> LocalResult<UTC>`

Creates the offset(s) for given local `NaiveDate` if possible.

#### `fn offset_from_local_datetime(&self, _local: &NaiveDateTime) -> LocalResult<UTC>`

Creates the offset(s) for given local `NaiveDateTime` if possible.

#### `fn offset_from_utc_date(&self, _utc: &NaiveDate) -> UTC`

Creates the offset for given UTC `NaiveDate`. This cannot fail.

#### `fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> UTC`

Creates the offset for given UTC `NaiveDateTime`. This cannot fail.

#### `fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>`

Makes a new `Date` from year, month, day and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more

#### `fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>`

Makes a new `Date` from year, month, day and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more

#### `fn yo(&self, year: i32, ordinal: u32) -> Date<Self>`

Makes a new `Date` from year, day of year (DOY or "ordinal") and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more

#### `fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>`

Makes a new `Date` from year, day of year (DOY or "ordinal") and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more

#### `fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>`

Makes a new `Date` from ISO week date (year and week number), day of the week (DOW) and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. The resulting `Date` may have a different year from the input year. Read more

#### `fn isoywd_opt(
&self,
year: i32,
week: u32,
weekday: Weekday
) -> LocalResult<Date<Self>>`

Makes a new `Date` from ISO week date (year and week number), day of the week (DOW) and the current time zone. This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. The resulting `Date` may have a different year from the input year. Read more

#### `fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>`

Makes a new `DateTime` from the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp") and the number of nanoseconds since the last whole non-leap second. Read more

#### `fn timestamp_opt(&self, secs: i64, nsecs: u32) -> LocalResult<DateTime<Self>>`

Makes a new `DateTime` from the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp") and the number of nanoseconds since the last whole non-leap second. Read more

#### `fn datetime_from_str(&self, s: &str, fmt: &str) -> ParseResult<DateTime<Self>>`

Parses a string with the specified format string and returns a `DateTime` with the current offset. See the `format::strftime` module on the supported escape sequences. Read more

#### `fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Self>>`

Converts the local `NaiveDate` to the timezone-aware `Date` if possible.

#### `fn from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<DateTime<Self>>`

Converts the local `NaiveDateTime` to the timezone-aware `DateTime` if possible.

#### `fn from_utc_date(&self, utc: &NaiveDate) -> Date<Self>`

Converts the UTC `NaiveDate` to the local time. The UTC is continuous and thus this cannot fail (but can give the duplicate local time). Read more

#### `fn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Self>`

Converts the UTC `NaiveDateTime` to the local time. The UTC is continuous and thus this cannot fail (but can give the duplicate local time). Read more

### `impl Offset for UTC`
[src]

#### `fn local_minus_utc(&self) -> Duration`

Returns the offset from UTC to the local time stored.

### `impl Debug for UTC`
[src]

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

Formats the value using the given formatter.

### `impl Display for UTC`
[src]

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

Formats the value using the given formatter. 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`)