Struct q_compress::data_types::TimestampNanos

pub struct TimestampNanos(_);

A nanosecond-precise, timezone-naive timestamp.

All q_compress timestamps use a signed 64 bit integer for the number of seconds since the Unix Epoch, which is a range of about +/- 500 million years. This is (generally) the most generous timestamp range standard used by other major tools today.

TimestampNanos in particular have fine enough granularity to losslessly convert timestamps for any operating system or (generally) major tool.

Implementations

impl TimestampNanos

pub fn new(parts: i128) -> QCompressResult<Self>

Returns a timestamp with the corresponding parts since the Unix Epoch. Will return an error if outside the bounds of a 64-bit signed integer for seconds and 32-bit unsigned integer for fractional parts.

pub fn from_secs_and_nanos(seconds: i64, subsec_nanos: u32) -> Self

Returns a timestamp with the corresponding seconds and fractional nanoseconds since the Unix Epoch.

pub fn to_secs_and_nanos(self) -> (i64, u32)

Returns the (seconds, subsec_nanos) since the Unix Epoch.

pub fn to_total_parts(self) -> i128

Returns the total number of parts (e.g. microseconds or nanoseconds) since the Unix Epoch.

pub fn validate(&self) -> QCompressResult<()>

Return an error if the timestamp is out of range.

Valid timestamps fit into a 64-bit signed integer for seconds and 32-bit unsigned integer for the fractional part of the second. However, the in-memory representation uses a 128-bit signed integer for the total number of fractional parts. It is theoretically possible for a corrupt delta-encoded file to cause a decompressor to return invalid timestamps. If you are concerned about a data corruption affecting such a case without being noticed, you may want to .validate() every returned timestamp. Otherwise, it is possible that a panic occurs when you try to use the corrupt timestamps.

Trait Implementations

impl Clone for TimestampNanos

fn clone(&self) -> TimestampNanos

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TimestampNanos

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

Formats the value using the given formatter.

impl Default for TimestampNanos

fn default() -> TimestampNanos

Returns the “default value” for a type.

impl Display for TimestampNanos

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

Formats the value using the given formatter.

impl From<SystemTime> for TimestampNanos

fn from(system_time: SystemTime) -> Self

Performs the conversion.

impl From<TimestampNanos> for SystemTime

fn from(value: TimestampNanos) -> SystemTime

Performs the conversion.

impl NumberLike for TimestampNanos

const HEADER_BYTE: u8

A number from 0-255 that corresponds to the number’s data type.

const PHYSICAL_BITS: usize

The number of bits in the number’s uncompressed representation. This must match the number of bytes in the to_bytes and from_bytes implementations. Note that booleans have 8 physical bits (not 1) and timestamps have 96 (not 128).

type Signed = i128

The signed integer this type can convert between to do wrapped subtraction and addition for delta encoding/decoding. Must be another NumberLike with the same Signed and Unsigned as this type; in this way, if we take 7th order deltas, they are ensured to have the same type as 1st order deltas.

type Unsigned = u128

The unsigned integer this type can convert between to do bitwise logic and such.

fn to_unsigned(self) -> u128

Used during compression to convert to an unsigned integer.

fn from_unsigned(off: u128) -> Self

Used during decompression to convert back from an unsigned integer.

fn to_signed(self) -> i128

Used during delta encoding to convert to a signed integer.

fn from_signed(signed: i128) -> Self

Used during delta decoding to convert back from a signed integer.

fn to_bytes(self) -> Vec<u8>

Returns an uncompressed representation for the number.

fn from_bytes(bytes: Vec<u8>) -> QCompressResult<Self>

Creates a number from an uncompressed representation.

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

Lossless check for bit-exact equality. This is important because not all data types support full ordering: https://stackoverflow.com/questions/26489701/why-does-rust-not-implement-total-ordering-via-the-ord-trait-for-f64-and-f32.

fn read_from(reader: &mut BitReader<'_>) -> QCompressResult<Self>

Parses an uncompressed representation of the number from the BitReader.

fn write_to(self, writer: &mut BitWriter)

Appends an uncompressed representation of the number to the BitWriter.

impl PartialEq<TimestampNanos> for TimestampNanos

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Copy for TimestampNanos

impl Eq for TimestampNanos

impl StructuralEq for TimestampNanos

impl StructuralPartialEq for TimestampNanos