Struct TzifFile 

pub struct TzifFile {
    pub version: Version,
    pub v1: DataBlock,
    pub v2_plus: Option<DataBlock>,
    pub footer: Option<String>,
}

Fields

version: Version

v1: DataBlock

v2_plus: Option<DataBlock>

footer: Option<String>

Implementations

impl TzifFile

pub fn interoperability_warnings( &self, ) -> Result<Vec<InteroperabilityWarning>, TzifError>

Returns interoperability warnings for readers with common legacy TZif limitations.

Errors

Returns an error if the file is not structurally valid.

impl TzifFile

pub const fn v1(block: DataBlock) -> Self

pub fn v2(v1: DataBlock, v2: DataBlock, footer: impl Into<String>) -> Self

pub fn v3(v1: DataBlock, v3: DataBlock, footer: impl Into<String>) -> Self

pub fn v4(v1: DataBlock, v4: DataBlock, footer: impl Into<String>) -> Self

pub fn validate(&self) -> Result<(), TzifError>

Validates this file against the structural TZif rules implemented by this crate.

Errors

Returns an error when the file contains invalid counts, indexes, version-specific data, footer content, or leap-second records.

impl TzifFile

pub fn deserialize(input: &[u8]) -> Result<Self, TzifError>

Deserializes a TZif byte slice into a validated file.

Errors

Returns an error if the input is malformed, truncated, has invalid counts or indexes, or fails semantic validation.

pub fn parse(input: &[u8]) -> Result<Self, TzifError>

Parses a TZif byte slice into a validated file.

Errors

Returns an error if the input cannot be deserialized as valid TZif.

impl TzifFile

pub fn has_leap_seconds(&self) -> bool

pub fn suggested_media_type(&self) -> &'static str

pub fn validate_for_media_type( &self, media_type: TzifMediaType, ) -> Result<(), TzdistError>

Validates that this file can be served as the requested media type.

Errors

Returns an error if the file is invalid, or if leap seconds are present in an application/tzif response.

pub fn validate_tzdist_truncation( &self, truncation: TzdistTruncation, ) -> Result<(), TzdistError>

Validates the structural TZif requirements for a TZDIST truncation response.

Errors

Returns an error if the file is not version 2 or later, lacks required transitions, has mismatched truncation boundaries, or does not use the required -00 placeholder types.

impl TzifFile

pub fn serialize(&self) -> Result<Vec<u8>, TzifError>

Serializes this file to TZif bytes after validating it.

Errors

Returns an error if the file is invalid or contains counts or timestamps that cannot be represented by the selected TZif version.

pub fn to_bytes(&self) -> Result<Vec<u8>, TzifError>

Serializes this file to TZif bytes.

Errors

Returns an error if serialization validation fails.

Trait Implementations

impl Clone for TzifFile

fn clone(&self) -> TzifFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TzifFile

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

Formats the value using the given formatter.

impl PartialEq for TzifFile

fn eq(&self, other: &TzifFile) -> 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 Eq for TzifFile

impl StructuralPartialEq for TzifFile