Struct IanaParserBorrowed

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

A borrowed wrapper around the time zone ID parser, returned by IanaParser::as_borrowed(). More efficient to query.

Implementations

impl IanaParserBorrowed<'static>

pub fn new() -> IanaParserBorrowed<'static>

Creates a new IanaParserBorrowed using compiled data.

See IanaParserBorrowed for an example.

✨ Enabled with the compiled_data Cargo feature.

📚 Help choosing a constructor

pub fn static_to_owned(&self) -> IanaParser

Cheaply converts a [IanaParserBorrowed<'static>] into a IanaParser.

Note: Due to branching and indirection, using IanaParser might inhibit some compile-time optimizations that are possible with IanaParserBorrowed.

impl<'a> IanaParserBorrowed<'a>

pub fn parse(&self, iana_id: &str) -> TimeZone

Gets the BCP-47 time zone ID from an IANA time zone ID with a case-insensitive lookup.

Returns TimeZone::unknown() if the IANA ID is not found.

Examples

use icu_time::zone::iana::IanaParser;
use icu_time::TimeZone;

let parser = IanaParser::new();

let result = parser.parse("Asia/CALCUTTA");

assert_eq!(*result, "inccu");

// Unknown IANA time zone ID:
assert_eq!(parser.parse("America/San_Francisco"), TimeZone::unknown());

pub fn parse_from_utf8(&self, iana_id: &[u8]) -> TimeZone

Same as Self::parse() but works with potentially ill-formed UTF-8.

pub fn iter(&self) -> TimeZoneIter<'a>

Returns an iterator over all known time zones.

Examples

use icu::time::zone::IanaParser;
use icu::time::zone::TimeZone;
use std::collections::BTreeSet;
use tinystr::tinystr;

let parser = IanaParser::new();

let ids = parser.iter().collect::<BTreeSet<_>>();

assert!(ids.contains(&TimeZone(tinystr!(8, "uaiev"))));

Trait Implementations

impl<'a> Clone for IanaParserBorrowed<'a>

fn clone(&self) -> IanaParserBorrowed<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for IanaParserBorrowed<'a>

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

Formats the value using the given formatter.

impl Default for IanaParserBorrowed<'static>

fn default() -> IanaParserBorrowed<'static>

Returns the “default value” for a type.

impl<'a> Copy for IanaParserBorrowed<'a>