Struct Timestamp 

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

Available on crate features model-mysql or model-postgres or model-sqlite only.

A UTC instant, microseconds since the Unix epoch.

use rust_web_server::model::Timestamp;

let t = Timestamp::parse("2026-11-04 12:34:56.5+00:00").unwrap();
assert_eq!(t.to_string(), "2026-11-04T12:34:56.500000Z");
assert_eq!(t, Timestamp::from_unix_micros(1_793_795_696_500_000));

Implementations

impl Timestamp

pub fn now() -> Timestamp

The current time (the system clock, truncated to microseconds).

pub const fn from_unix_micros(micros: i64) -> Timestamp

The instant micros microseconds after the Unix epoch.

pub const fn from_unix_seconds(seconds: i64) -> Timestamp

The instant seconds seconds after the Unix epoch.

pub const fn unix_micros(self) -> i64

Microseconds since the Unix epoch.

pub const fn unix_seconds(self) -> i64

Whole seconds since the Unix epoch (rounded down).

pub fn parse(text: &str) -> Result<Timestamp, DbError>

Parse YYYY-MM-DD, optionally followed by T or a space, HH:MM[:SS[.fraction]] and a zone (Z, ±HH, ±HHMM, ±HH:MM; none means UTC). Digits past the sixth of the fraction are dropped.

pub fn to_rfc3339(self) -> String

RFC 3339 in UTC with six fraction digits: 2026-11-04T12:34:56.123456Z (also what Display writes).

pub fn to_value(self, backend: Backend) -> Value

The value rws binds for this instant on backend: RFC 3339 text, or YYYY-MM-DD HH:MM:SS.ffffff on MySQL, whose DATETIME takes no zone designator.

Trait Implementations

impl Clone for Timestamp

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 Timestamp

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Self

Returns the “default value” for a type.

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

Available on crate feature serde only.

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

Deserialize this value from the given Serde deserializer.

impl Display for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl FromColumn for Timestamp

fn from_column(v: Value) -> Result<Self, DbError>

impl FromStr for Timestamp

type Err = DbError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this 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: &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 Timestamp

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Timestamp

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 Timestamp

Available on crate feature serde only.

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 ToColumn for Timestamp

fn to_column(&self) -> Value