Enum Format

#[non_exhaustive]
pub enum Format {
    Constant(String),
    Alternate {
        standard: String,
        dst: String,
    },
    Placeholder(String),
    Offset,
}

The format string to generate a time zone abbreviation from.

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.

Constant(String)

A constant format, which remains the same throughout both standard and DST timespans.

Alternate

An alternate format, such as “PST/PDT”, which changes between standard and DST timespans.

Fields

standard: String

Abbreviation to use during Standard Time.

dst: String

Abbreviation to use during Summer Time.

Placeholder(String)

A format with a placeholder %s, which uses the letters field in a RuleInfo to generate the time zone abbreviation.

Offset

The special %z placeholder that gets formatted as a numeric offset.

Implementations

impl Format

pub fn new(template: &str) -> Format

Convert the template into one of the Format variants. This can’t fail, as any syntax that doesn’t match one of the two formats will just be a ‘constant’ format.

pub fn format( &self, utc_offset: i64, dst_offset: i64, letters: Option<&String>, ) -> String

pub fn format_constant(&self) -> String

Trait Implementations

impl Clone for Format

fn clone(&self) -> Format

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Format

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

Formats the value using the given formatter.

impl PartialEq for Format

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