Struct DateTime

pub struct DateTime<A>
where
    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> DateTime<A>

where A: AsCalendar,

pub fn try_from_str( rfc_9557_str: &str, calendar: A, ) -> Result<DateTime<A>, 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<DateTime<A>, 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 for DateTime<A>

where A: Clone + AsCalendar,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C, A> ConvertCalendar for DateTime<A>

where C: IntoAnyCalendar, A: AsCalendar<Calendar = C>,

type Converted<'a> = DateTime<Ref<'a, AnyCalendar>>

The converted type. This can be the same as the receiver type.

fn to_calendar<'a>( &self, calendar: &'a AnyCalendar, ) -> <DateTime<A> as ConvertCalendar>::Converted<'a>

Converts self to the specified AnyCalendar.

impl<A> Debug for DateTime<A>

where A: Debug + AsCalendar,

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

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<DateTime<Iso>, <DateTime<Iso> as FromStr>::Err>

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

impl<C, A> GetField<()> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self)

Returns the value of this trait’s field T.

impl<C, A> GetField<DayOfMonth> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> DayOfMonth

Returns the value of this trait’s field T.

impl<C, A> GetField<DayOfYear> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> DayOfYear

Returns the value of this trait’s field T.

impl<C, A> GetField<Hour> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> Hour

Returns the value of this trait’s field T.

impl<C, A> GetField<Minute> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> Minute

Returns the value of this trait’s field T.

impl<C, A> GetField<MonthInfo> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> MonthInfo

Returns the value of this trait’s field T.

impl<C, A> GetField<Nanosecond> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> Nanosecond

Returns the value of this trait’s field T.

impl<C, A> GetField<Second> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> Second

Returns the value of this trait’s field T.

impl<C, A> GetField<Weekday> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> Weekday

Returns the value of this trait’s field T.

impl<C, A> GetField<YearInfo> for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,

fn get_field(&self) -> YearInfo

Returns the value of this trait’s field T.

impl<C, A> InSameCalendar for DateTime<A>

where C: IntoAnyCalendar, A: AsCalendar<Calendar = C>,

fn check_any_calendar_kind( &self, any_calendar_kind: AnyCalendarKind, ) -> Result<(), MismatchedCalendarError>

Checks whether this type is compatible with the given calendar.

impl<A> PartialEq for DateTime<A>

where A: PartialEq + AsCalendar,

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 for DateTime<A>

where A: Copy + AsCalendar,

impl<A> Eq for DateTime<A>

where A: Eq + AsCalendar,

impl<C, A> InFixedCalendar<C> for DateTime<A>

where C: CldrCalendar, A: AsCalendar<Calendar = C>,

impl<A> StructuralPartialEq for DateTime<A>

where A: AsCalendar,

impl<C, A> UnstableSealed for DateTime<A>

where C: Calendar, A: AsCalendar<Calendar = C>,