Struct NanoTimestamp 

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

Exchange-epoch timestamp with nanosecond resolution.

Stores nanoseconds since the Unix epoch (UTC). The inner field is private; use NanoTimestamp::new to construct and NanoTimestamp::nanos to read.

Implementations

impl NanoTimestamp

pub const MIN: NanoTimestamp

Smallest representable timestamp (earliest possible time).

pub const MAX: NanoTimestamp

Largest representable timestamp (latest possible time).

pub fn new(nanos: i64) -> Self

Constructs a NanoTimestamp from a raw nanosecond integer.

pub fn nanos(&self) -> i64

Returns the raw nanosecond value.

pub fn as_nanos(&self) -> u128

Returns the raw nanosecond value as u128.

Saturates to zero for negative timestamps (before the epoch).

pub fn now() -> Self

Returns the current UTC time as a NanoTimestamp.

Falls back to 0 if the system clock overflows nanosecond range (extremely unlikely).

pub fn elapsed(&self) -> i64

Returns the nanoseconds elapsed since self (i.e. NanoTimestamp::now() - self).

Positive when self is in the past, negative when self is in the future.

pub fn duration_since(&self, other: NanoTimestamp) -> i64

Returns the signed nanosecond difference self - other.

Positive when self is later than other, negative when earlier.

pub fn diff_millis(&self, other: NanoTimestamp) -> i64

Returns the signed millisecond difference self - other.

Positive when self is later than other. Rounds toward zero (truncates sub-millisecond nanoseconds).

pub fn elapsed_nanos_since(&self, other: NanoTimestamp) -> Option<i64>

Returns Some(nanos) if self >= other (non-negative elapsed time), otherwise None.

Use this when you want to measure forward elapsed time and treat a negative difference as “not yet elapsed” rather than a negative value.

pub fn add_nanos(&self, nanos: i64) -> NanoTimestamp

Returns a new NanoTimestamp offset by nanos (positive = forward in time).

pub fn add_millis(&self, ms: i64) -> NanoTimestamp

Returns a new NanoTimestamp offset by ms milliseconds.

pub fn add_seconds(&self, secs: i64) -> NanoTimestamp

Returns a new NanoTimestamp offset by secs seconds.

pub fn add_minutes(&self, minutes: i64) -> NanoTimestamp

Shifts this timestamp forward by minutes minutes (negative values go backwards).

pub fn add_hours(&self, hours: i64) -> NanoTimestamp

Shifts this timestamp forward by hours hours (negative values go backwards).

pub fn is_before(&self, other: NanoTimestamp) -> bool

Returns true if self is strictly earlier than other.

pub fn is_after(&self, other: NanoTimestamp) -> bool

Returns true if self is strictly later than other.

pub fn is_same_second(&self, other: NanoTimestamp) -> bool

Returns true if self and other fall within the same calendar second.

Two timestamps are in the same second when floor(self / 1_000_000_000) == floor(other / 1_000_000_000).

pub fn is_same_minute(&self, other: NanoTimestamp) -> bool

Returns true if self and other fall within the same calendar minute.

Two timestamps are in the same minute when floor(self / 60_000_000_000) == floor(other / 60_000_000_000).

pub fn from_millis(ms: i64) -> Self

Constructs a NanoTimestamp from milliseconds since the Unix epoch.

pub fn to_millis(&self) -> i64

Returns milliseconds since the Unix epoch (truncates sub-millisecond precision).

pub fn from_secs(secs: i64) -> Self

Constructs a NanoTimestamp from whole seconds since the Unix epoch.

pub fn to_secs(&self) -> i64

Returns whole seconds since the Unix epoch (truncates sub-second precision).

pub fn from_datetime(dt: DateTime<Utc>) -> Self

Constructs a NanoTimestamp from a DateTime<Utc>.

Falls back to 0 if the datetime is outside the representable nanosecond range.

pub fn to_datetime(&self) -> DateTime<Utc>

Converts this timestamp to a DateTime<Utc>.

pub fn to_seconds(&self) -> f64

Converts this timestamp to floating-point seconds since the Unix epoch.

pub fn duration_millis(self, other: NanoTimestamp) -> i64

Returns the signed millisecond difference self - other.

Positive when self is after other.

pub fn min(self, other: NanoTimestamp) -> NanoTimestamp

Returns the earlier of self and other.

pub fn max(self, other: NanoTimestamp) -> NanoTimestamp

Returns the later of self and other.

pub fn elapsed_since(self, earlier: NanoTimestamp) -> i64

Returns the signed nanosecond difference self - earlier.

Positive when self is after earlier, negative when before. Use for computing durations between two timestamps without assuming ordering.

pub fn seconds_since(self, earlier: NanoTimestamp) -> i64

Returns the difference in whole seconds: (self - earlier) / 1_000_000_000.

Positive when self is after earlier.

pub fn minutes_since(self, earlier: NanoTimestamp) -> i64

Returns the difference in whole minutes: (self - earlier) / 60_000_000_000.

Positive when self is after earlier.

pub fn hours_since(self, earlier: NanoTimestamp) -> i64

Returns the difference in whole hours: (self - earlier) / 3_600_000_000_000.

Positive when self is after earlier.

pub fn round_down_to(&self, period_nanos: i64) -> NanoTimestamp

Snaps this timestamp down to the nearest multiple of period_nanos.

For example, rounding ts=1_500_000_000 down to period_nanos=1_000_000_000 yields 1_000_000_000. Useful for bar-boundary calculations.

Returns self unchanged when period_nanos == 0.

pub fn to_date_string(&self) -> String

Formats this timestamp as a UTC date string "YYYY-MM-DD".

Useful for grouping bars or ticks by calendar date (e.g., daily session boundaries).

pub fn is_same_day(&self, other: NanoTimestamp) -> bool

Returns true if self and other fall on the same UTC calendar day.

Useful for detecting session boundaries when grouping bars by date.

pub fn floor_to_hour(&self) -> NanoTimestamp

Floors this timestamp to the start of the current UTC minute.

Floors this timestamp to the start of the current UTC hour.

Truncates minutes, seconds, and nanoseconds: returns HH:00:00.000000000.

pub fn hour_of_day(self) -> u8

Returns the UTC hour of day (0–23).

pub fn minute_of_hour(self) -> u8

Returns the minute within the current UTC hour (0–59).

pub fn is_market_hours(self, open_hour: u8, close_hour: u8) -> bool

Returns true if the UTC hour falls within [open_hour, close_hour).

Useful for checking whether a timestamp is within a trading session. Both open_hour and close_hour must be in 0–23; if open_hour >= close_hour the function returns false.

pub fn floor_to_day(&self) -> NanoTimestamp

Floors this timestamp to midnight UTC (start of the day).

Truncates hours, minutes, seconds, and nanoseconds: returns 00:00:00.000000000.

pub fn floor_to_minute(&self) -> NanoTimestamp

Truncates nanoseconds and seconds: returns the timestamp at HH:MM:00.000000000.

pub fn elapsed_seconds(&self, other: NanoTimestamp) -> f64

Returns the signed elapsed time between self and other in seconds.

Positive when self is after other. Resolution is nanoseconds.

pub fn to_datetime_string(&self) -> String

Formats this timestamp as a UTC datetime string "YYYY-MM-DD HH:MM:SS".

Useful for logging and display when a full datetime is needed rather than just the date.

pub fn is_between(self, start: NanoTimestamp, end: NanoTimestamp) -> bool

Returns true if self falls within [start, end] (inclusive on both ends).

pub fn to_unix_ms(self) -> i64

Converts this timestamp to Unix milliseconds (truncating sub-millisecond precision).

pub fn to_unix_seconds(self) -> i64

Returns whole seconds since the Unix epoch (truncates sub-second precision).

pub fn second_of_minute(self) -> u8

Returns the second within the current UTC minute (0–59).

pub fn day_of_week(self) -> u8

Returns the day of the week as u8 where Monday = 0 and Sunday = 6.

Computed from the Unix epoch (1970-01-01 was a Thursday = 3).

pub fn sub_minutes(&self, minutes: i64) -> NanoTimestamp

Shifts the timestamp backward by minutes minutes.

Equivalent to add_minutes(-minutes).

pub fn is_weekend(self) -> bool

Returns true if this timestamp falls on a Saturday (5) or Sunday (6) in UTC.

pub fn start_of_week(self) -> NanoTimestamp

Returns the timestamp floored to Monday 00:00:00 UTC of the containing week.

pub fn add_days(&self, days: i64) -> NanoTimestamp

Shifts the timestamp forward by days calendar days (positive or negative).

pub fn minutes_between(self, other: NanoTimestamp) -> u64

Returns the absolute number of whole minutes between self and other.

pub fn seconds_between(self, other: NanoTimestamp) -> u64

Returns the absolute number of whole seconds between self and other.

pub fn day_of_year(self) -> u16

Returns the day of the year (1 = January 1, 365/366 = December 31).

Uses the UTC calendar. The Unix epoch (1970-01-01) is day 1.

pub fn quarter(self) -> u8

Returns the quarter number: 1 (Jan–Mar), 2 (Apr–Jun), 3 (Jul–Sep), or 4 (Oct–Dec).

Uses the UTC calendar.

pub fn week_of_year(self) -> u32

Returns the ISO 8601 week number (1–53).

Uses the UTC calendar. Week 1 is the first week containing a Thursday.

pub fn is_same_week(self, other: NanoTimestamp) -> bool

Returns true if self and other fall in the same ISO calendar week and year.

pub fn is_same_month(self, other: NanoTimestamp) -> bool

Returns true if self and other fall in the same calendar month and year.

pub fn floor_to_week(self) -> NanoTimestamp

Snaps this timestamp to the most recent Monday at 00:00:00 UTC (start of ISO week).

pub fn is_same_year(self, other: NanoTimestamp) -> bool

Returns true if self and other fall in the same calendar year.

pub fn days_between(self, other: NanoTimestamp) -> u64

Returns the absolute number of calendar days between two timestamps.

pub fn end_of_day(self) -> NanoTimestamp

Returns a NanoTimestamp at 23:59:59.999_999_999 UTC on the same calendar day.

pub fn start_of_month(self) -> NanoTimestamp

Returns a NanoTimestamp at 00:00:00.000_000_000 UTC on the first day of the same month.

pub fn end_of_month(self) -> NanoTimestamp

Returns a NanoTimestamp at 23:59:59.999_999_999 UTC on the last day of the same month.

pub fn floor_to_second(self) -> NanoTimestamp

Truncates the timestamp to the nearest whole second.

pub fn is_same_hour(self, other: NanoTimestamp) -> bool

Returns true if both timestamps fall in the same UTC hour.

pub fn add_weeks(&self, weeks: i64) -> NanoTimestamp

Shifts the timestamp forward by weeks weeks (negative shifts backward).

pub fn sub_hours(&self, hours: i64) -> NanoTimestamp

Shifts the timestamp backward by hours hours.

pub fn sub_weeks(&self, weeks: i64) -> NanoTimestamp

Shifts the timestamp backward by weeks weeks.

pub fn sub_seconds(&self, secs: i64) -> NanoTimestamp

Shifts the timestamp backward by secs seconds.

pub fn to_time_string(&self) -> String

Formats the timestamp as "HH:MM:SS" in UTC.

pub fn elapsed_hours(&self, other: NanoTimestamp) -> f64

Elapsed time in hours between self and other (always non-negative).

pub fn is_today(&self, other: NanoTimestamp) -> bool

Returns true if this timestamp falls on the same UTC calendar day as other.

pub fn nanoseconds_between(self, other: NanoTimestamp) -> u64

Absolute difference in nanoseconds between self and other.

pub fn elapsed_minutes(&self, other: NanoTimestamp) -> f64

Elapsed time in minutes between self and other (always non-negative).

pub fn elapsed_days(&self, other: NanoTimestamp) -> f64

Elapsed time in calendar days (as a float) between self and other.

pub fn sub_nanos(&self, nanos: i64) -> NanoTimestamp

Shifts the timestamp backward by nanos nanoseconds.

pub fn start_of_year(self) -> NanoTimestamp

Truncates to the first nanosecond of the UTC year (January 1, 00:00:00.000000000).

pub fn end_of_year(self) -> NanoTimestamp

Returns the last nanosecond of the UTC year containing this timestamp.

pub fn add_months(&self, months: i32) -> NanoTimestamp

Adds months calendar months, clamping to the last day of the resulting month.

pub fn start_of_quarter(self) -> NanoTimestamp

Returns the NanoTimestamp at the start of the current calendar quarter (Jan/Apr/Jul/Oct 1 00:00:00.000000000 UTC).

pub fn end_of_quarter(self) -> NanoTimestamp

Returns the NanoTimestamp at the last nanosecond of the current calendar quarter.

pub fn is_same_quarter(self, other: NanoTimestamp) -> bool

Returns true if self and other fall in the same calendar quarter and year.

Trait Implementations

impl Add<i64> for NanoTimestamp

NanoTimestamp + i64 shifts the timestamp forward by nanos nanoseconds.

type Output = NanoTimestamp

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> NanoTimestamp

Performs the + operation.

impl Clone for NanoTimestamp

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 NanoTimestamp

impl Debug for NanoTimestamp

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NanoTimestamp

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NanoTimestamp

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

Formats the value using the given formatter.

impl Eq for NanoTimestamp

impl Ord for NanoTimestamp

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 NanoTimestamp

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for NanoTimestamp

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 Serialize for NanoTimestamp

Available on crate feature serde only.

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 NanoTimestamp

impl Sub for NanoTimestamp

NanoTimestamp - NanoTimestamp returns the signed nanosecond difference.

type Output = i64

The resulting type after applying the - operator.

fn sub(self, rhs: NanoTimestamp) -> i64

Performs the - operation.

impl Sub<i64> for NanoTimestamp

NanoTimestamp - i64 shifts the timestamp backward by nanos nanoseconds.

type Output = NanoTimestamp

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> NanoTimestamp

Performs the - operation.