pub enum TzOffset {
Unspecified,
Utc,
Hours(i32),
Minutes(i32),
}Expand description
A parsed EDTF timezone.
If features = ["chrono"] is enabled, then this can act as a chrono::TimeZone. This can be
used to preserve the level of TZ brevity i.e. TzOffset::Hours(_) ends up as +04 instead of
+04:00.
Variants§
Unspecified
An EDTF with no timezone information at all. Not RFC3339-compliant. Not rendered at all when formatting an Edtf.
If this is used as a chrono::TimeZone, then it may be coerced into Utc when combined with other tz implementations, like chrono::offset::FixedOffset.
Utc
Z
Hours(i32)
+04
A number of hours only. Not RFC3339-compliant.
In order to provide lossless parse-format roundtrips, this will be formatted without the
:00, so if you want timestamps to be RFC3339-compliant, do not use this. Because of this,
you may wish to use the chrono interop to format an RFC3339 timestamp instead of the
Display implementation on DateTime.
Minutes(i32)
+04:30
A number of minutes offset from UTC.
Trait Implementations§
Source§impl Offset for TzOffset
Available on crate feature chrono only.
impl Offset for TzOffset
chrono only.Source§fn fix(&self) -> FixedOffset
fn fix(&self) -> FixedOffset
Source§impl TimeZone for TzOffset
Available on crate feature chrono only.
impl TimeZone for TzOffset
chrono only.Source§type Offset = TzOffset
type Offset = TzOffset
TimeZone value can be recovered via TimeZone::from_offset.Source§fn from_offset(offset: &Self::Offset) -> Self
fn from_offset(offset: &Self::Offset) -> Self
Source§fn offset_from_local_date(
&self,
_local: &NaiveDate,
) -> LocalResult<Self::Offset>
fn offset_from_local_date( &self, _local: &NaiveDate, ) -> LocalResult<Self::Offset>
NaiveDate if possible.Source§fn offset_from_local_datetime(
&self,
_local: &NaiveDateTime,
) -> LocalResult<Self::Offset>
fn offset_from_local_datetime( &self, _local: &NaiveDateTime, ) -> LocalResult<Self::Offset>
NaiveDateTime if possible.Source§fn offset_from_utc_date(&self, _utc: &NaiveDate) -> Self::Offset
fn offset_from_utc_date(&self, _utc: &NaiveDate) -> Self::Offset
NaiveDate. This cannot fail.Source§fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> Self::Offset
fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> Self::Offset
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>>
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>
with_ymd_and_hms() insteadDate 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>>
with_ymd_and_hms() insteadDate 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>
from_local_datetime() with a NaiveDateTime insteadDate 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>>
from_local_datetime() with a NaiveDateTime insteadDate 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>
from_local_datetime() with a NaiveDateTime insteadDate 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>>
from_local_datetime() with a NaiveDateTime insteadDate 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>
timestamp_opt() insteadDateTime 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>>
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>
timestamp_millis_opt() insteadDateTime 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>>
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>
DateTime from the number of non-leap nanoseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read moreSource§fn timestamp_micros(&self, micros: i64) -> LocalResult<DateTime<Self>>
fn timestamp_micros(&self, micros: i64) -> LocalResult<DateTime<Self>>
DateTime from the number of non-leap microseconds
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>
DateTime::parse_from_str or NaiveDateTime::parse_from_str with and_utc() or and_local_timezone() insteadDateTime 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>>
from_local_datetime() insteadNaiveDate 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>>
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>
from_utc_datetime() insteadNaiveDate 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>
NaiveDateTime to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time).