Struct tea_time::DateTime

source ·

#[repr(transparent)]
pub struct DateTime<U: TimeUnitTrait = Nanosecond>(pub i64, _);

Expand description

Represents a date and time with a specific time unit precision.

§Type Parameters

U: The time unit precision, defaulting to Nanosecond. Must implement TimeUnitTrait.

§Fields

0: An i64 representing the timestamp in the specified time unit.
PhantomData: A zero-sized type used to “mark” the time unit without affecting the struct’s memory layout.

Tuple Fields§

§0: i64

Implementations§

source §

impl<U: TimeUnitTrait> DateTime

source

pub const fn new(dt: i64) -> Self

Creates a new DateTime instance with the given timestamp.

§Arguments

dt - An i64 representing the timestamp in the specified time unit.

§Returns

A new DateTime instance.

source

pub const fn is_nat(&self) -> bool

Checks if the DateTime instance represents “Not-a-Time” (NaT).

§Returns

true if the instance is NaT, false otherwise.

source

pub const fn is_not_nat(&self) -> bool

Checks if the DateTime instance represents a valid time (not NaT).

§Returns

true if the instance is not NaT, false otherwise.

source

pub const fn nat() -> Self

Creates a new DateTime instance representing “Not-a-Time” (NaT).

§Returns

A new DateTime instance representing NaT.

source

pub const fn into_i64(self) -> i64

Converts the DateTime instance to its underlying i64 timestamp.

§Returns

The i64 timestamp value.

source

pub const fn from_opt_i64(v: Option<i64>) -> Self

Creates a DateTime instance from an optional i64 timestamp.

§Arguments

v - An Option<i64> representing the timestamp.

§Returns

A new DateTime instance. If v is None, returns NaT.

source

pub const fn into_opt_i64(self) -> Option<i64>

Converts the DateTime instance to an optional i64 timestamp.

§Returns

Some(i64) if the instance is not NaT, None otherwise.

source

pub fn to_cr(&self) -> Option<CrDateTime<Utc>>
where Self: TryInto<CrDateTime<Utc>>,

👎Deprecated since 0.5.0: use as_cr instead

Converts the DateTime instance to a chrono::DateTime<Utc>.

§Returns

Some(CrDateTime<Utc>) if the conversion is successful, None if the instance is NaT.

source

pub fn as_cr(&self) -> Option<CrDateTime<Utc>>
where Self: TryInto<CrDateTime<Utc>>,

source

pub fn parse(s: &str, fmt: Option<&str>) -> TResult<Self>
where Self: From<CrDateTime<Utc>>,

Parses a string into a DateTime instance.

§Arguments

s - The string to parse.
fmt - An optional format string. If None, tries multiple common formats.

§Returns

A TResult<Self> containing the parsed DateTime or an error.

source

pub fn strftime(&self, fmt: Option<&str>) -> String
where Self: TryInto<CrDateTime<Utc>>, <Self as TryInto<CrDateTime<Utc>>>::Error: Debug,

Formats the DateTime instance as a string.

§Arguments

fmt - An optional format string. If None, uses “%Y-%m-%d %H:%M:%S.%f”.

§Returns

A formatted string representation of the DateTime.

source

pub fn duration_trunc(self, duration: TimeDelta) -> Self
where Self: TryInto<CrDateTime<Utc>> + From<CrDateTime<Utc>>, <Self as TryInto<CrDateTime<Utc>>>::Error: Debug,

Truncates the DateTime to a specified duration.

§Arguments

duration - A TimeDelta specifying the truncation interval.

§Returns

A new DateTime instance truncated to the specified duration.

source §

impl<U: TimeUnitTrait> DateTime
where Self: TryInto<DateTime<Utc>>,

source

pub fn time(&self) -> Option<NaiveTime>

Returns the time component of the DateTime as a NaiveTime.

§Returns

Option<NaiveTime>: The time component if the DateTime is valid, or None if it’s NaT.

source

pub fn year(&self) -> Option<i32>

Returns the year.

§Returns

Option<i32>: The year if the DateTime is valid, or None if it’s NaT.

source

pub fn day(&self) -> Option<usize>

Returns the day of the month (1-31).

§Returns

Option<usize>: The day of the month if the DateTime is valid, or None if it’s NaT.

source

pub fn month(&self) -> Option<usize>

Returns the month (1-12).

§Returns

Option<usize>: The month if the DateTime is valid, or None if it’s NaT.

source

pub fn hour(&self) -> Option<usize>

Returns the hour (0-23).

§Returns

Option<usize>: The hour if the DateTime is valid, or None if it’s NaT.

source

pub fn minute(&self) -> Option<usize>

Returns the minute (0-59).

§Returns

Option<usize>: The minute if the DateTime is valid, or None if it’s NaT.

source

pub fn second(&self) -> Option<usize>

Returns the second (0-59).

§Returns

Option<usize>: The second if the DateTime is valid, or None if it’s NaT.

source §

impl<U: TimeUnitTrait> DateTime

source

pub fn into_unit<T: TimeUnitTrait>(self) -> DateTime<T>

Trait Implementations§

source §

impl<U: TimeUnitTrait> Add<TimeDelta> for DateTime
where Self: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

source §

type Output = DateTime

The resulting type after applying the + operator.

source §

fn add(self, rhs: TimeDelta) -> Self::Output

Performs the + operation. Read more

source §

impl<U: Clone + TimeUnitTrait> Clone for DateTime

source §

fn clone(&self) -> DateTime

Returns a copy of the value. Read more

1.0.0 · source§

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

Performs copy-assignment from source. Read more

source §

impl<U: TimeUnitTrait> Debug for DateTime
where Self: TryInto<DateTime<Utc>>, <Self as TryInto<DateTime<Utc>>>::Error: Debug,

source §

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

Formats the value using the given formatter. Read more

source §

impl<U: TimeUnitTrait> Default for DateTime

source §

fn default() -> Self

Returns the “default value” for a type. Read more

source §