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() -> Self

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 TimeZone from a case-insensitive IANA time zone ID.

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.as_str(), "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::locale::subtags::subtag;
use icu::time::zone::IanaParser;
use icu::time::zone::TimeZone;
use std::collections::BTreeSet;

let parser = IanaParser::new();

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

assert!(ids.contains(&TimeZone(subtag!("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

Formats the value using the given formatter.

impl Default for IanaParserBorrowed<'static>

fn default() -> Self

Returns the “default value” for a type.

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