Struct DateTime

pub struct DateTime<A: AsCalendar> {
    pub date: Date<A>,
    pub time: Time,
}

A date and time for a given calendar.

The primary definition of this type is in the icu_time crate. Other ICU4X crates re-export it for convenience.

Fields

date: Date<A>

The date

time: Time

The time

Implementations

impl<A: AsCalendar> DateTime<A>

pub fn try_from_str(rfc_9557_str: &str, calendar: A) -> Result<Self, ParseError>

Creates a DateTime in any calendar from an RFC 9557 string.

Returns an error if the string has a calendar annotation that does not match the calendar argument, unless the argument is Iso.

✨ Enabled with the ixdtf Cargo feature.

Examples

use icu::calendar::cal::Hebrew;
use icu::time::DateTime;

let datetime =
    DateTime::try_from_str("2024-07-17T16:01:17.045[u-ca=hebrew]", Hebrew)
        .unwrap();

assert_eq!(datetime.date.era_year().year, 5784);
assert_eq!(
    datetime.date.month().standard_code,
    icu::calendar::types::MonthCode(tinystr::tinystr!(4, "M10"))
);
assert_eq!(datetime.date.day_of_month().0, 11);

assert_eq!(datetime.time.hour.number(), 16);
assert_eq!(datetime.time.minute.number(), 1);
assert_eq!(datetime.time.second.number(), 17);
assert_eq!(datetime.time.subsecond.number(), 45000000);

pub fn try_from_utf8( rfc_9557_str: &[u8], calendar: A, ) -> Result<Self, ParseError>

Creates a DateTime in any calendar from an RFC 9557 string.

See Self::try_from_str().

✨ Enabled with the ixdtf Cargo feature.

Trait Implementations

impl<A: Clone + AsCalendar> Clone for DateTime<A>

fn clone(&self) -> DateTime<A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Debug + AsCalendar> Debug for DateTime<A>

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

Formats the value using the given formatter.

impl FromStr for DateTime<Iso>

type Err = ParseError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl<A: PartialEq + AsCalendar> PartialEq for DateTime<A>

fn eq(&self, other: &DateTime<A>) -> 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<A: Copy + AsCalendar> Copy for DateTime<A>

impl<A: Eq + AsCalendar> Eq for DateTime<A>

impl<A: AsCalendar> StructuralPartialEq for DateTime<A>