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.

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: 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.

✨ 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<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: AsCalendar> Clone for DateTime<A>

where Date<A>: Clone,

fn clone(&self) -> Self

Returns a duplicate 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 From<DateTime> for DateTime<Gregorian>

fn from(jiff: DateTime) -> Self

Converts to this type from the input type.

impl From<NaiveDateTime> for DateTime<Gregorian>

fn from(chrono: NaiveDateTime) -> Self

Converts to this type from the input type.

impl From<PrimitiveDateTime> for DateTime<Gregorian>

fn from(chrono: PrimitiveDateTime) -> Self

Converts to this type from the input type.

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

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

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

where Date<A>: Copy,

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

where Date<A>: Eq,