Struct UnixNanos 

pub struct UnixNanos(/* private fields */);

Represents a timestamp in nanoseconds since the UNIX epoch.

Implementations

impl UnixNanos

pub const fn new(value: u64) -> Self

Creates a new UnixNanos instance.

pub const fn max() -> Self

Creates a new UnixNanos instance with the maximum valid value.

pub const fn is_zero(&self) -> bool

Returns true if the value of this instance is zero.

pub const fn as_u64(&self) -> u64

Returns the underlying value as u64.

pub const fn as_seconds(&self) -> u64

Returns the timestamp as seconds, truncating sub-second precision.

pub const fn as_millis(&self) -> u64

Returns the timestamp as milliseconds, truncating sub-millisecond precision.

pub const fn as_micros(&self) -> u64

Returns the timestamp as microseconds, truncating sub-microsecond precision.

pub const fn from_seconds(seconds: u64) -> Self

Creates a new UnixNanos from a second timestamp.

Panics

Panics if the result overflows u64.

pub const fn from_millis(millis: u64) -> Self

Creates a new UnixNanos from a millisecond timestamp.

Panics

Panics if the result overflows u64.

pub const fn from_millis_checked(millis: i64) -> Option<Self>

Creates a new UnixNanos from a signed millisecond timestamp.

Returns None if millis is negative or the result overflows u64.

pub const fn from_micros(micros: u64) -> Self

Creates a new UnixNanos from a microsecond timestamp.

Panics

Panics if the result overflows u64.

pub const fn from_micros_checked(micros: i64) -> Option<Self>

Creates a new UnixNanos from a signed microsecond timestamp.

Returns None if micros is negative or the result overflows u64.

pub const fn as_i64(&self) -> i64

Returns the underlying value as i64.

Panics

Panics if the value exceeds i64::MAX (approximately year 2262).

pub const fn as_f64(&self) -> f64

Returns the underlying value as f64.

pub fn to_datetime_utc(&self) -> Timestamp

Converts the underlying value to a datetime (UTC).

Panics

Panics if Jiff’s supported timestamp range no longer includes all u64 nanosecond values.

pub fn to_rfc3339(&self) -> String

Converts the underlying value to an ISO 8601 (RFC 3339) string.

pub const fn duration_since(&self, other: &Self) -> Option<DurationNanos>

Calculates the duration in nanoseconds since another UnixNanos instance.

Returns Some(duration) if self is later than other, otherwise None if other is greater than self (indicating a negative duration is not possible with DurationNanos).

pub const fn saturating_duration_since(&self, earlier: Self) -> DurationNanos

Calculates the duration in nanoseconds since earlier, saturating at zero.

pub const fn floor(self, interval: DurationNanos) -> Self

Rounds this timestamp down to the nearest multiple of interval since the UNIX epoch.

Panics

Panics if interval is zero.

pub const fn checked_add(self, rhs: DurationNanos) -> Option<Self>

Returns Some(self + rhs) or None if the addition would overflow

pub const fn checked_sub(self, rhs: DurationNanos) -> Option<Self>

Returns Some(self - rhs) or None if the subtraction would underflow

pub const fn saturating_add(self, rhs: DurationNanos) -> Self

Adds rhs, saturating at UnixNanos::max.

pub const fn saturating_sub(self, rhs: DurationNanos) -> Self

Subtracts rhs, saturating at zero.

Methods from Deref<Target = u64>

pub const MIN: u64 = 0

pub const MAX: u64

pub const BITS: u32

Trait Implementations

impl Add<DurationNanos> for UnixNanos

Adds a duration to a timestamp.

Panics

Panics on overflow. Use UnixNanos::checked_add or UnixNanos::saturating_add for explicit overflow handling.

type Output = UnixNanos

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<DurationNanos> for UnixNanos

Add-assigns a duration to UnixNanos.

Panics

Panics on overflow. This is intentional fail-fast behavior for timestamp arithmetic.

fn add_assign(&mut self, rhs: DurationNanos)

Performs the += operation.

impl Clone for UnixNanos

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 UnixNanos

impl Debug for UnixNanos

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

Formats the value using the given formatter.

impl Default for UnixNanos

fn default() -> Self

Returns the “default value” for a type.

impl Deref for UnixNanos

type Target = u64

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de> Deserialize<'de> for UnixNanos

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UnixNanos

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

Formats the value using the given formatter.

impl Eq for UnixNanos

impl From<&str> for UnixNanos

Converts a string slice to UnixNanos.

Panics

This implementation will panic if the string cannot be parsed into a valid UnixNanos. This is intentional fail-fast behavior where invalid timestamps indicate a critical logic error that should halt execution rather than silently propagate incorrect data.

For error handling without panicking, use str::parse::<UnixNanos>() which returns a Result.

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for UnixNanos

Converts a String to UnixNanos.

Panics

This implementation will panic if the string cannot be parsed into a valid UnixNanos. This is intentional fail-fast behavior where invalid timestamps indicate a critical logic error that should halt execution rather than silently propagate incorrect data.

For error handling without panicking, use str::parse::<UnixNanos>() which returns a Result.

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<SystemTime> for UnixNanos

fn from(value: SystemTime) -> Self

Converts to this type from the input type.

impl From<Timestamp> for UnixNanos

fn from(value: Timestamp) -> Self

Converts to this type from the input type.

impl From<UnixNanos> for u64

fn from(value: UnixNanos) -> Self

Converts to this type from the input type.

impl From<UnixNanos> for Timestamp

fn from(value: UnixNanos) -> Self

Converts to this type from the input type.

impl From<u64> for UnixNanos

fn from(value: u64) -> Self

Converts to this type from the input type.

impl FromStr for UnixNanos

type Err = Box<dyn Error>

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for UnixNanos

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 UnixNanos

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 UnixNanos

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<Option<u64>> for UnixNanos

fn eq(&self, other: &Option<u64>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<UnixNanos> for u64

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<u64> for UnixNanos

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for UnixNanos

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 PartialOrd<Option<u64>> for UnixNanos

fn partial_cmp(&self, other: &Option<u64>) -> 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 PartialOrd<UnixNanos> for u64

fn partial_cmp(&self, other: &UnixNanos) -> 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 PartialOrd<u64> for UnixNanos

fn partial_cmp(&self, other: &u64) -> 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 Serialize for UnixNanos

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UnixNanos

impl Sub for UnixNanos

Returns the elapsed duration between two timestamps.

Panics

Panics if rhs is later than self. Use UnixNanos::duration_since or UnixNanos::saturating_duration_since when the timestamps may be out of order.

type Output = DurationNanos

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl Sub<DurationNanos> for UnixNanos

Subtracts a duration from a timestamp.

Panics

Panics on underflow. Use UnixNanos::checked_sub or UnixNanos::saturating_sub for explicit underflow handling.

type Output = UnixNanos

The resulting type after applying the - operator.

fn sub(self, rhs: DurationNanos) -> Self::Output

Performs the - operation.

impl SubAssign<DurationNanos> for UnixNanos

Sub-assigns a duration from UnixNanos.

Panics

Panics on underflow. This is intentional fail-fast behavior for timestamp arithmetic.

fn sub_assign(&mut self, rhs: DurationNanos)

Performs the -= operation.