Enum edtf::TzOffset

pub enum TzOffset {
    Unspecified,
    Utc,
    Hours(i32),
    Minutes(i32),
}

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.

Tuple Fields of Hours

0: i32

Minutes(i32)

+04:30 A number of minutes offset from UTC.

Tuple Fields of Minutes

0: i32

Trait Implementations

impl Clone for TzOffset

fn clone(&self) -> TzOffset

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TzOffset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for TzOffset

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Offset for TzOffset

This is supported on crate feature chrono only.

fn fix(&self) -> FixedOffset

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

impl PartialEq<TzOffset> for TzOffset

fn eq(&self, other: &TzOffset) -> bool

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

fn ne(&self, other: &TzOffset) -> bool

This method tests for !=.

impl TimeZone for TzOffset

This is supported on crate feature chrono only.

type Offset = Self

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(offset: &Self::Offset) -> Self

Reconstructs the time zone from the offset.

fn offset_from_local_date(
    &self,
    _local: &NaiveDate
) -> LocalResult<Self::Offset>

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

fn offset_from_local_datetime(
    &self,
    _local: &NaiveDateTime
) -> LocalResult<Self::Offset>

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

fn offset_from_utc_date(&self, _utc: &NaiveDate) -> Self::Offset

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

fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> Self::Offset

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

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. 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 Copy for TzOffset

impl Eq for TzOffset

impl StructuralEq for TzOffset

impl StructuralPartialEq for TzOffset