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_micros(micros: u64) -> Self

Creates a new UnixNanos from a microsecond timestamp.

Panics

Panics if 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 const fn to_datetime_utc(&self) -> DateTime<Utc>

Converts the underlying value to a datetime (UTC).

Panics

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

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 fn checked_add<T: Into<u64>>(self, rhs: T) -> Option<Self>

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

pub fn checked_sub<T: Into<u64>>(self, rhs: T) -> Option<Self>

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

pub fn saturating_add_ns<T: Into<u64>>(self, rhs: T) -> Self

Saturating addition – if overflow occurs the value is clamped to u64::MAX.

pub fn saturating_sub_ns<T: Into<u64>>(self, rhs: T) -> Self

Saturating subtraction – if underflow occurs the value is clamped to 0.

Methods from Deref<Target = u64>

pub const MIN: u64 = 0

pub const MAX: u64

pub const BITS: u32

Trait Implementations

impl Add for UnixNanos

Adds two UnixNanos values.

Panics

Panics on overflow. This is intentional fail-fast behavior: overflow in timestamp arithmetic indicates a logic error in calculations that would corrupt data. Use UnixNanos::checked_add() or UnixNanos::saturating_add_ns() if you need explicit overflow handling.

type Output = UnixNanos

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<u64> for UnixNanos

Adds a u64 nanosecond value to UnixNanos.

Panics

Panics on overflow. This is intentional fail-fast behavior for timestamp arithmetic. Use UnixNanos::checked_add() for explicit overflow handling.

type Output = UnixNanos

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Into<u64>> AddAssign<T> for UnixNanos

Add-assigns a value to UnixNanos.

Panics

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

fn add_assign(&mut self, other: T)

Performs the += operation.

impl Clone for UnixNanos

fn clone(&self) -> UnixNanos

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() -> UnixNanos

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<DateTime<Utc>> for UnixNanos

fn from(value: DateTime<Utc>) -> 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<UnixNanos> for u64

fn from(value: UnixNanos) -> Self

Converts to this type from the input type.

impl From<UnixNanos> for DateTime<Utc>

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: &UnixNanos) -> 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 UnixNanos

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

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

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

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

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

Subtracts one UnixNanos from another.

Panics

Panics on underflow. This is intentional fail-fast behavior: underflow in timestamp arithmetic indicates a logic error in calculations that would corrupt data. Use UnixNanos::checked_sub() or UnixNanos::saturating_sub_ns() if you need explicit underflow handling.

type Output = UnixNanos

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<u64> for UnixNanos

Subtracts a u64 nanosecond value from UnixNanos.

Panics

Panics on underflow. This is intentional fail-fast behavior for timestamp arithmetic. Use UnixNanos::checked_sub() for explicit underflow handling.

type Output = UnixNanos

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Into<u64>> SubAssign<T> for UnixNanos

Sub-assigns a value from UnixNanos.

Panics

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

fn sub_assign(&mut self, other: T)

Performs the -= operation.