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.with_ymd_and_hms(1970, 1, 1, 0, 1, 1).unwrap(), dt);
Implementations§
Trait Implementations§
source§impl Offset for Utc
impl Offset for Utc
source§fn fix(&self) -> FixedOffset
fn fix(&self) -> FixedOffset
Returns the fixed offset from UTC to the local time stored.
source§impl TimeZone for Utc
impl TimeZone for Utc
§type Offset = Utc
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
.source§fn from_offset(_state: &Utc) -> Utc
fn from_offset(_state: &Utc) -> Utc
Reconstructs the time zone from the offset.
source§fn offset_from_local_date(&self, _local: &NaiveDate) -> LocalResult<Utc>
fn offset_from_local_date(&self, _local: &NaiveDate) -> LocalResult<Utc>
Creates the offset(s) for given local
NaiveDate
if possible.source§fn offset_from_local_datetime(&self, _local: &NaiveDateTime) -> LocalResult<Utc>
fn offset_from_local_datetime(&self, _local: &NaiveDateTime) -> LocalResult<Utc>
Creates the offset(s) for given local
NaiveDateTime
if possible.source§fn offset_from_utc_date(&self, _utc: &NaiveDate) -> Utc
fn offset_from_utc_date(&self, _utc: &NaiveDate) -> Utc
Creates the offset for given UTC
NaiveDate
. This cannot fail.source§fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> Utc
fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> Utc
Creates the offset for given UTC
NaiveDateTime
. This cannot fail.source§fn with_ymd_and_hms(
&self,
year: i32,
month: u32,
day: u32,
hour: u32,
min: u32,
sec: u32
) -> LocalResult<DateTime<Self>>
fn with_ymd_and_hms( &self, year: i32, month: u32, day: u32, hour: u32, min: u32, sec: u32 ) -> LocalResult<DateTime<Self>>
Make a new
DateTime
from year, month, day, time components and current time zone. Read moresource§fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>
fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>
👎Deprecated since 0.4.23: use
with_ymd_and_hms()
insteadMakes 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 moresource§fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>
fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>
👎Deprecated since 0.4.23: use
with_ymd_and_hms()
insteadMakes 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 moresource§fn yo(&self, year: i32, ordinal: u32) -> Date<Self>
fn yo(&self, year: i32, ordinal: u32) -> Date<Self>
👎Deprecated since 0.4.23: use
from_local_datetime()
with a NaiveDateTime
insteadMakes 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 moresource§fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>
fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>
👎Deprecated since 0.4.23: use
from_local_datetime()
with a NaiveDateTime
insteadMakes 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 moresource§fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>
fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>
👎Deprecated since 0.4.23: use
from_local_datetime()
with a NaiveDateTime
insteadMakes 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 moresource§fn isoywd_opt(
&self,
year: i32,
week: u32,
weekday: Weekday
) -> LocalResult<Date<Self>>
fn isoywd_opt( &self, year: i32, week: u32, weekday: Weekday ) -> LocalResult<Date<Self>>
👎Deprecated since 0.4.23: use
from_local_datetime()
with a NaiveDateTime
insteadMakes 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 moresource§fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>
fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>
👎Deprecated since 0.4.23: use
timestamp_opt()
insteadMakes 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 moresource§fn timestamp_opt(&self, secs: i64, nsecs: u32) -> LocalResult<DateTime<Self>>
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 moresource§fn timestamp_millis(&self, millis: i64) -> DateTime<Self>
fn timestamp_millis(&self, millis: i64) -> DateTime<Self>
👎Deprecated since 0.4.23: use
timestamp_millis_opt()
insteadMakes a new
DateTime
from the number of non-leap milliseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read moresource§fn timestamp_millis_opt(&self, millis: i64) -> LocalResult<DateTime<Self>>
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”). Read moresource§fn timestamp_nanos(&self, nanos: i64) -> DateTime<Self>
fn timestamp_nanos(&self, nanos: i64) -> DateTime<Self>
Makes a new
DateTime
from the number of non-leap nanoseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read moresource§fn datetime_from_str(
&self,
s: &str,
fmt: &str
) -> Result<DateTime<Self>, ParseError>
fn datetime_from_str( &self, s: &str, fmt: &str ) -> Result<DateTime<Self>, ParseError>
Parses a string with the specified format string and returns a
DateTime
with the current offset. Read moresource§fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Self>>
fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Self>>
👎Deprecated since 0.4.23: use
from_local_datetime()
insteadConverts the local
NaiveDate
to the timezone-aware Date
if possible.source§fn from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<DateTime<Self>>
fn from_local_datetime( &self, local: &NaiveDateTime ) -> LocalResult<DateTime<Self>>
Converts the local
NaiveDateTime
to the timezone-aware DateTime
if possible.source§fn from_utc_date(&self, utc: &NaiveDate) -> Date<Self>
fn from_utc_date(&self, utc: &NaiveDate) -> Date<Self>
👎Deprecated since 0.4.23: use
from_utc_datetime()
insteadConverts the UTC
NaiveDate
to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time).source§fn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Self>
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 Copy for Utc
impl Eq for Utc
impl StructuralEq for Utc
impl StructuralPartialEq for Utc
Auto Trait Implementations§
impl RefUnwindSafe for Utc
impl Send for Utc
impl Sync for Utc
impl Unpin for Utc
impl UnwindSafe for Utc
Blanket Implementations§
source§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to
key
and return true
if they are equal.