Struct UtcDateTime 

pub struct UtcDateTime(pub Timestamp);

An absolute instant in UTC (nanosecond-precision Unix timeline).

Tuple Fields

0: Timestamp

Underlying nanosecond-precision UTC instant (jiff::Timestamp).

Implementations

impl UtcDateTime

pub fn now() -> Effect<Self, Never, ()>

Current system time as UTC (Timestamp::now).

pub fn from_epoch_millis(ms: i64) -> Option<Self>

Construct from Unix milliseconds when in range.

pub fn unsafe_make(ms: i64) -> Self

Construct from Unix milliseconds; panics when out of range (caller assertion, not unsafe).

pub fn from_std(t: SystemTime) -> Option<Self>

Convert from SystemTime (fallible on out-of-range values).

pub fn inner(self) -> Timestamp

Unwrap to the raw Timestamp.

pub fn to_epoch_millis(&self) -> i64

Unix time in whole milliseconds.

pub fn to_zoned(self, zone: TimeZone) -> ZonedDateTime

View / project this instant into a specific IANA or fixed-offset zone.

pub fn year(&self) -> i16

Civil year in UTC.

pub fn month(&self) -> i8

Civil month in UTC (1–12).

pub fn day(&self) -> i8

Civil day of month in UTC.

pub fn hour(&self) -> i8

Civil hour in UTC (0–23).

pub fn minute(&self) -> i8

Civil minute in UTC.

pub fn second(&self) -> i8

Civil second in UTC.

pub fn add_duration(&self, d: Duration) -> Self

Add d to this instant; panics on overflow.

pub fn subtract_duration(&self, d: Duration) -> Self

Subtract d from this instant; panics on underflow.

pub fn start_of(&self, unit: TimeUnit) -> Self

First instant of the unit (UTC civil calendar).

pub fn end_of(&self, unit: TimeUnit) -> Self

Last representable instant inside the unit (UTC civil calendar), inclusive.

pub fn nearest(&self, unit: TimeUnit) -> Self

Round to the nearest boundary of unit (UTC civil calendar).

pub fn distance_millis(&self, other: &Self) -> i64

Signed difference other − self in whole milliseconds.

pub fn distance_duration(&self, other: &Self) -> Duration

Absolute span between self and other as Duration.

pub fn format_iso(&self) -> String

RFC 3339 / ISO-8601 instant string with Z suffix.

pub fn format(&self, fmt: &str) -> String

strftime-style formatting in UTC.

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

Strictly before other on the UTC timeline.

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

Strictly after other on the UTC timeline.

pub fn between(&self, min: &Self, max: &Self) -> bool

Inclusive range check between min and max on the UTC timeline.

Trait Implementations

impl Clone for UtcDateTime

fn clone(&self) -> UtcDateTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UtcDateTime

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

Formats the value using the given formatter.

impl Hash for UtcDateTime

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 UtcDateTime

fn cmp(&self, other: &UtcDateTime) -> 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.

impl PartialEq for UtcDateTime

fn eq(&self, other: &UtcDateTime) -> 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 PartialOrd for UtcDateTime

fn partial_cmp(&self, other: &UtcDateTime) -> 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 Copy for UtcDateTime

impl Eq for UtcDateTime

impl StructuralPartialEq for UtcDateTime