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.

This type exists as an input type for datetime formatting and should only be constructed to pass to a datetime formatter.

Semantics

This type represents the date and time that are displayed to a user. It does not identify the absolute time that an event happens, nor does it represent the general concept of a “local date time”, which would require time zone and leap second information for operations like validation, arithmetic, and comparisons.

Hence, while this type implements PartialEq/Eq (equal DateTimes will display equally), it does not implement PartialOrd/Ord, arithmetic, and it is possible to create DateTimes that do not exist for a particular timezone.

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.

✨ 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().to_input().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: AsCalendar, Date<A>: Clone,

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

Returns a duplicate 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> Copy for DateTime<A>

where A: AsCalendar, Date<A>: Copy,

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

where A: AsCalendar, Date<A>: Eq,

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

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

fn get_field(&self) -> RataDie

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

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

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, B> PartialEq<DateTime<B>> for DateTime<A>

where A: AsCalendar, B: AsCalendar, Date<A>: PartialEq<Date<B>>,

fn eq(&self, other: &DateTime<B>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

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

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