Struct DateTime 

pub struct DateTime {
    pub date: Date,
    pub time: Time,
}

A day and a time of day, without a time zone.

Fields

date: Date

time: Time

Implementations

impl DateTime

pub const fn new(date: Date, time: Time) -> DateTime

pub fn now_utc() -> DateTime

Now, in UTC.

pub fn now_local() -> DateTime

Now, in the local zone, summer time included.

use rich_interact::datetime::DateTime;

assert!(DateTime::now_local().is_valid());

pub fn now_in(zone: &Zone) -> DateTime

Now, on zone’s clocks.

pub fn from_unix(unix: i64, zone: &Zone) -> DateTime

The moment unix (seconds since 1970-01-01 00:00 UTC) on zone’s clocks.

use rich_interact::datetime::{Date, DateTime, Time, Zone};

let at = DateTime::from_unix(1_792_404_000, &Zone::Fixed(7200));
assert_eq!(at, DateTime::new(Date::new(2026, 10, 19), Time::new(12, 0, 0)));
assert_eq!(at.to_unix(&Zone::Fixed(7200)), 1_792_404_000);

pub fn to_unix(self, zone: &Zone) -> i64

The moment this is on zone’s clocks, in seconds since 1970 UTC. A time the clocks pass twice (when summer time ends) is the first of the two; one they skip (when it starts) is read on the clock of before the change, so 02:30 in a gap from 02:00 to 03:00 is 03:30.

pub fn add_seconds(self, seconds: i64) -> DateTime

The moment seconds later (earlier if negative), on a clock that does not change (as UTC’s): add to to_unix for a zone’s.

pub const fn is_valid(self) -> bool

Whether both halves are valid.

pub fn format(self, seconds: bool, twelve_hour: bool) -> String

Written as 2026-10-17 14:30, with the time as Time::format writes it.

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DateTime

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Display for DateTime

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

2026-10-17 14:30, or 2026-10-17 14:30:05 when the seconds are not 0.

impl Eq for DateTime

impl From<Date> for DateTime

fn from(date: Date) -> DateTime

The day at midnight.

impl FromStr for DateTime

fn from_str(text: &str) -> Result<DateTime, String>

A Date, then a space or T, then a Time (2026-10-17 14:30, 2026-10-17T14:30:05, 2026-10-17 2:30 pm); a date alone is at midnight; now is now (in UTC).

type Err = String

The associated error which can be returned from parsing.

impl Hash for DateTime

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for DateTime

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for DateTime

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for DateTime

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for DateTime