Struct TimeZoneParser

pub struct TimeZoneParser<'a> { /* private fields */ }

A parser for time zone offset and IANA identifier strings.

✨ Enabled with the timezone Cargo feature.

Implementations

impl<'a> TimeZoneParser<'a>

pub fn from_utf8(source: &'a [u8]) -> Self

Creates a new TimeZoneParser from a slice of utf-8 bytes.

pub fn from_str(source: &'a str) -> Self

Creates a new TimeZoneParser from a source &str.

pub fn parse_offset(&mut self) -> ParserResult<UtcOffsetRecord>

Parse a UTC offset from the provided source.

This method can parse both a minute precision and full precision offset.

Minute precision offset example

use ixdtf::parsers::{records::Sign, TimeZoneParser};

let offset_src = "-05:00";
let parse_result =
    TimeZoneParser::from_str(offset_src).parse_offset().unwrap();
assert_eq!(parse_result.sign(), Sign::Negative);
assert_eq!(parse_result.hour(), 5);
assert_eq!(parse_result.minute(), 0);
assert_eq!(parse_result.second(), None);
assert_eq!(parse_result.fraction(), None);

Full precision offset example

use ixdtf::parsers::{records::Sign, TimeZoneParser};

let offset_src = "-05:00:30.123456789";
let parse_result =
    TimeZoneParser::from_str(offset_src).parse_offset().unwrap();
assert_eq!(parse_result.sign(), Sign::Negative);
assert_eq!(parse_result.hour(), 5);
assert_eq!(parse_result.minute(), 0);
assert_eq!(parse_result.second(), Some(30));
let fraction = parse_result.fraction().unwrap();
assert_eq!(fraction.to_nanoseconds(), Some(123456789));

pub fn parse_iana_identifier(&mut self) -> ParserResult<&'a [u8]>

Parse an IANA identifier name.

use ixdtf::parsers::{records::Sign, TimeZoneParser};

let iana_identifier = "America/Chicago";
let parse_result = TimeZoneParser::from_str(iana_identifier)
    .parse_iana_identifier()
    .unwrap();
assert_eq!(parse_result, iana_identifier.as_bytes());

let iana_identifier = "Europe/Berlin";
let parse_result = TimeZoneParser::from_str(iana_identifier)
    .parse_iana_identifier()
    .unwrap();
assert_eq!(parse_result, iana_identifier.as_bytes());

Trait Implementations

impl<'a> Debug for TimeZoneParser<'a>

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

Formats the value using the given formatter.