Struct Timestamp 

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

An instant in UTC, serialized as an RFC 3339 string with a zero offset.

Implementations

impl Timestamp

pub fn now() -> Self

The instant now.

pub fn from_unix_seconds(seconds: i64) -> Result<Self, TimestampError>

The instant this many seconds after the Unix epoch.

Errors

Returns an error when the count of seconds denotes no representable instant.

pub fn plus_seconds(self, seconds: i64) -> Result<Self, TimestampError>

The instant this many seconds after this one.

Sub-second precision is kept rather than dropped: an adjustment asked to stand for a minute stands for a minute, rather than for a minute less however far into a second it happened to be made.

Errors

Returns an error when the result is not a representable instant.

pub fn latest() -> Self

The latest instant this type writes as a string it reads back.

The last moment of the year 9999: RFC 3339 spells a year in four digits, so a later instant is written with a sign and more digits that no RFC 3339 reader accepts — and that a store ordering instants by their text would order before every earlier one. Reading what is due by this instant reads everything due at any instant this type can record.

Panics

Never: the instant is a fixed one every chrono represents.

pub const fn as_utc(&self) -> &DateTime<Utc>

The instant as the UTC date-time it is.

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<'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 Display for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl From<DateTime<Utc>> for Timestamp

fn from(instant: DateTime<Utc>) -> Self

Converts to this type from the input type.

impl FromStr for Timestamp

type Err = TimestampError

The associated error which can be returned from parsing.

fn from_str(text: &str) -> Result<Self, Self::Err>

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

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

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

fn sample_full() -> Self

A value carrying every field the type declares.

fn sample_minimal() -> Self

A value carrying every optional field absent.

fn sample_alternates() -> Vec<Self>

One value per further arm, for a type whose wire form is a union.

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