Struct LocalTimeOffsetEntry 

pub struct LocalTimeOffsetEntry {
    pub country_code: LangCode,
    pub country_region_id: u8,
    pub local_time_offset_negative: bool,
    pub local_time_offset_bcd: u16,
    pub next_time_offset_bcd: u16,
    /* private fields */
}

One per-country offset entry.

Fields

country_code: LangCode

ISO 3166 alpha country code.

country_region_id: u8

6-bit country_region_id for sub-national regions.

local_time_offset_negative: bool

Polarity: false = offset is positive (local = UTC + offset), true = offset is negative (local = UTC − offset).

local_time_offset_bcd: u16

16-bit BCD HHMM local time offset.

next_time_offset_bcd: u16

16-bit BCD HHMM next offset (applied after time_of_change).

Implementations

impl LocalTimeOffsetEntry

pub fn new( country_code: LangCode, country_region_id: u8, local_time_offset_negative: bool, local_time_offset_bcd: u16, time_of_change_raw: [u8; 5], next_time_offset_bcd: u16, ) -> Self

Create a new entry with all fields specified.

pub fn time_of_change_parts(&self) -> (u16, Option<u8>, Option<u8>, Option<u8>)

Decode time_of_change_raw into its MJD + BCD HHMMSS components without requiring the chrono feature.

Returns (mjd, hours, minutes, seconds). Each BCD field is None if its nibbles are non-decimal.

pub fn time_of_change_raw(&self) -> [u8; 5]

The raw 5-byte MJD+BCD time-of-change field (for serialization).

pub fn set_time_of_change_raw(&mut self, raw: [u8; 5])

Set the time_of_change_raw field directly.

impl LocalTimeOffsetEntry

pub fn local_time_offset(&self) -> Option<Duration>

Decode local_time_offset (BCD HHMM, signed by local_time_offset_negative) to a chrono::Duration. None if the BCD nibbles are out of range.

pub fn next_time_offset(&self) -> Option<Duration>

Decode next_time_offset (BCD HHMM) to a chrono::Duration. It shares the single local_time_offset_negative polarity bit (EN 300 468 §6.2.20). None if the BCD nibbles are out of range.

pub fn time_of_change(&self) -> Option<DateTime<Utc>>

Decode time_of_change_raw (16-bit MJD + 24-bit BCD UTC) to a UTC datetime. None if the date/time fields are out of range.

pub fn set_time_of_change(&mut self, dt: DateTime<Utc>) -> Result<()>

Set the time_of_change, encoding it into the 40-bit raw field.

Errors

ValueOutOfRange if the date is outside the representable 16-bit MJD range.

pub fn set_offsets(&mut self, local: Duration, next: Duration) -> Result<()>

Set both offsets and the shared polarity bit from signed durations.

The wire format carries one polarity bit for both offsets, so local and next must share a sign (zero matches either).

Errors

ValueOutOfRange if the two offsets disagree in sign or a magnitude is 100 hours or longer.

Trait Implementations

impl Clone for LocalTimeOffsetEntry

fn clone(&self) -> LocalTimeOffsetEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LocalTimeOffsetEntry

impl Debug for LocalTimeOffsetEntry

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

Formats the value using the given formatter.

impl Eq for LocalTimeOffsetEntry

impl PartialEq for LocalTimeOffsetEntry

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LocalTimeOffsetEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LocalTimeOffsetEntry