Struct chrono::offset::Utc

[+] Show declaration

pub struct Utc;

[−] Expand description

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

Using the TimeZone methods on the UTC struct is the preferred way to construct DateTime<Utc> instances.

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);
assert_eq!(Utc.ymd(1970, 1, 1).and_hms(0, 1, 1), dt);

Methods

impl Utc[−]

pub fn today() -> Date<Utc>[−]

Returns a Date which corresponds to the current date.

pub fn now() -> DateTime<Utc>[−]

Returns a DateTime which corresponds to the current date.

Trait Implementations

impl Offset for Utc[+]

[+] Show hidden undocumented items

fn fix(&self) -> FixedOffset[−]

Returns the fixed offset from UTC to the local time stored.

impl TimeZone for Utc[+]

[+] Show hidden undocumented items

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.

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.

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.

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.

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.

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.

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.

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.

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.

fn timestamp_millis(&self, millis: i64) -> DateTime<Self>[−]

Makes a new DateTime from the number of non-leap milliseconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp").

fn timestamp_millis_opt(&self, millis: i64) -> LocalResult<DateTime<Self>>[−]

Makes a new DateTime from the number of non-leap milliseconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp").

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.

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

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

impl PartialEq<Utc> for Utc[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Utc) -> bool[−]

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

[+] Expand attributes

#[must_use]

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

This method tests for !=.

impl Clone for Utc[+]

[+] Show hidden undocumented items

fn clone(&self) -> Utc[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl Eq for Utc

impl Copy for Utc

impl Debug for Utc[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.

impl Display for Utc[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.