Struct icu_datetime::mock::zoned_datetime::MockZonedDateTime

pub struct MockZonedDateTime {
    pub datetime: DateTime<Gregorian>,
    pub time_zone: MockTimeZone,
}

A temporary struct that implements ZonedDateTimeInput and is used in tests, benchmarks and examples of this component.

The composition of DateTime<Gregorian> and MockTimeZone.

Notice: Rust at the moment does not have a canonical way to represent date and time. We are introducing MockZonedDateTime as an example of the data necessary for ICU ZonedDateTimeFormat to work, and we hope to work with the community to develop core date and time APIs that will work as an input for this component.

Examples

use icu::datetime::mock::parse_gregorian_from_str;
use icu::datetime::mock::time_zone::MockTimeZone;
use icu::calendar::{DateTime, Gregorian};
use icu::datetime::mock::zoned_datetime::MockZonedDateTime;

let dt: DateTime<Gregorian> = parse_gregorian_from_str("2020-10-14T13:21:00")
    .expect("Failed to parse a datetime.");

let tz: MockTimeZone = "+05:00".parse()
    .expect("Failed to parse a time zone.");

let zdt1 = MockZonedDateTime::new(dt, tz);
let zdt2: MockZonedDateTime = "2020-10-14T13:21:00+05:00".parse()
    .expect("Failed to parse a zoned datetime.");

Fields

datetime: DateTime<Gregorian>

The datetime component.

time_zone: MockTimeZone

The time zone component.

Implementations

impl MockZonedDateTime

pub const fn new(datetime: DateTime<Gregorian>, time_zone: MockTimeZone) -> Self

Creates a new MockZonedDateTime from an already validated DateTime<Gregorian> and MockTimeZone.

Trait Implementations

impl DateInput for MockZonedDateTime

type Calendar = Gregorian

The CLDR calendar this date relates to

fn year(&self) -> Option<Year>

Gets the era and year input.

fn month(&self) -> Option<Month>

Gets the month input.

fn day_of_month(&self) -> Option<DayOfMonth>

Gets the day input.

fn iso_weekday(&self) -> Option<IsoWeekday>

Gets the weekday input.

fn day_of_year_info(&self) -> Option<DayOfYearInfo>

Gets information on the position of the day within the year.

impl Debug for MockZonedDateTime

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

Formats the value using the given formatter.

impl FromStr for MockZonedDateTime

fn from_str(input: &str) -> Result<Self, Self::Err>

Parse a MockZonedDateTime from a string.

This utility is for easily creating dates, not a complete robust solution. The string must take a specific form of the ISO 8601 format: YYYY-MM-DDThh:mm:ssZ, YYYY-MM-DDThh:mm:ss±hh, YYYY-MM-DDThh:mm:ss±hhmm, YYYY-MM-DDThh:mm:ss±hh:mm,

Examples

use icu::datetime::mock::zoned_datetime::MockZonedDateTime;

let date: MockZonedDateTime = "2020-10-14T13:21:00+05:30".parse()
    .expect("Failed to parse a zoned datetime.");

type Err = DateTimeError

The associated error which can be returned from parsing.

impl IsoTimeInput for MockZonedDateTime

fn hour(&self) -> Option<IsoHour>

Gets the hour input.

fn minute(&self) -> Option<IsoMinute>

Gets the minute input.

fn second(&self) -> Option<IsoSecond>

Gets the second input.

fn nanosecond(&self) -> Option<NanoSecond>

Gets the nanosecond input.

impl TimeZoneInput for MockZonedDateTime

fn gmt_offset(&self) -> GmtOffset

The GMT offset in Nanoseconds.

fn time_zone_id(&self) -> Option<&TimeZoneBcp47Id>

The IANA time-zone identifier.

fn metazone_id(&self) -> Option<&MetaZoneId>

The metazone identifier.

fn time_variant(&self) -> Option<&TinyStr8>

The time variant (e.g. “daylight”, “standard”)