Enum TimezoneSource 

#[non_exhaustive]
pub enum TimezoneSource {
    Local,
    Utc,
    Named(Tz),
}

Resolved timezone source. Built once at startup; used for every per-line render. #[non_exhaustive] so a future variant (e.g., explicit FixedOffset) can be added in minor releases.

Example

use rusty_ts::TimezoneSource;

// Three ways to construct a timezone source:
let local = TimezoneSource::Local;
let utc = TimezoneSource::Utc;
let tokyo = TimezoneSource::named("Asia/Tokyo").expect("valid IANA");

// Unknown IANA names return Error::InvalidIanaName.
assert!(TimezoneSource::named("Atlantis/Atlantica").is_err());

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Local

System local time as adjusted by the TZ env var if set.

Utc

UTC (no offset, no DST).

Named(Tz)

A named IANA zone.

Implementations

impl TimezoneSource

pub fn local() -> Self

Build a TimezoneSource::Local.

pub fn utc() -> Self

Build a TimezoneSource::Utc.

pub fn named(iana: &str) -> Result<Self, Error>

Resolve an IANA name (e.g., "America/New_York") via chrono-tz. Returns Error::InvalidIanaName if the name is not recognized.

pub fn render(&self, instant: DateTime<Utc>, fmt: &str) -> String

Format a UTC instant as the zone-local wall-clock string using the provided strftime format. The rendering cost is uniform across the three variants — a single offset conversion per call.

Trait Implementations

impl Clone for TimezoneSource

fn clone(&self) -> TimezoneSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimezoneSource

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

Formats the value using the given formatter.