Struct Timestamp 

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

A whole-second Unix timestamp used for access time and expiration.

Also used for object creation times. Values range from the Unix epoch through 9999-12-31T23:59:59Z. When constructed with fractional seconds, the timestamp rounds up to the next whole second. Values outside this range are rejected.

Serializes in the same format as SystemTime, with secs_since_epoch and nanos_since_epoch fields. The nanoseconds field is always zero when serialized. Deserialization accepts legacy fractional timestamps and rounds them upward.

use std::time::Duration;
use objectstore_types::time::Timestamp;

let deadline = Timestamp::from_unix_micros(1_700_000_000_123_456)?;
assert_eq!(deadline.as_rfc3339().to_string(), "2023-11-14T22:13:21Z");
let extended = deadline + Duration::from_secs(60);
assert_eq!(extended.as_secs(), deadline.as_secs() + 60);

Implementations

impl Timestamp

pub const UNIX_EPOCH: Self

The Unix epoch.

pub fn now() -> Self

Captures the current wall-clock time, rounded up to a whole second.

Panics

Panics if the system clock is outside the supported timestamp range.

pub fn from_unix_secs(seconds: u64) -> Result<Self, InvalidTimestamp>

Constructs a timestamp from whole Unix seconds.

pub fn from_unix_micros(micros: i64) -> Result<Self, InvalidTimestamp>

Constructs a timestamp from Unix microseconds, rounding fractional seconds upward.

pub fn from_rfc3339(value: &str) -> Result<Self, TimestampError>

Parses an RFC3339 timestamp, rounding fractional seconds upward.

Returns an error if the input is invalid or outside the supported timestamp range.

pub fn as_secs(self) -> u64

Returns the timestamp in whole Unix seconds.

pub fn as_micros(self) -> u64

Returns the second-aligned timestamp in Unix microseconds.

pub fn as_rfc3339(self) -> Rfc3339Timestamp

Returns a copy that displays and serializes as an RFC3339 string.

pub fn checked_add(self, duration: Duration) -> Option<Self>

Adds a duration, rounding upward, or returns None if the result is out of range.

pub fn checked_sub(self, duration: Duration) -> Option<Self>

Subtracts a duration, rounding upward, or returns None if the result precedes the epoch.

pub fn checked_duration_since(self, earlier: Self) -> Option<Duration>

Returns the elapsed duration, or None if earlier is later than this timestamp.

Trait Implementations

impl Add<Duration> for Timestamp

fn add(self, duration: Duration) -> Self

Adds a duration, rounding up. Panics if the result is outside the supported range.

type Output = Timestamp

The resulting type after applying the + operator.

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Timestamp

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Timestamp

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

Deserialize this value from the given Serde deserializer.

impl Eq for Timestamp

impl From<Timestamp> for SystemTime

fn from(time: Timestamp) -> Self

Converts to this type from the input type.

impl Hash for Timestamp

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 Timestamp

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

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

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

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Timestamp

impl Sub<Duration> for Timestamp

fn sub(self, duration: Duration) -> Self

Subtracts a duration, rounding up. Panics if the result precedes the epoch.

type Output = Timestamp

The resulting type after applying the - operator.

impl TryFrom<SystemTime> for Timestamp

type Error = InvalidTimestamp

The type returned in the event of a conversion error.

fn try_from(time: SystemTime) -> Result<Self, Self::Error>

Performs the conversion.