Struct TimestampArithmetic

pub struct TimestampArithmetic { /* private fields */ }

Options for Timestamp::checked_add and Timestamp::checked_sub.

This type provides a way to ergonomically add one of a few different duration types to a Timestamp.

The main way to construct values of this type is with its From trait implementations:

• From<Span> for TimestampArithmetic adds (or subtracts) the given span to the receiver timestamp.
• From<SignedDuration> for TimestampArithmetic adds (or subtracts) the given signed duration to the receiver timestamp.
• From<std::time::Duration> for TimestampArithmetic adds (or subtracts) the given unsigned duration to the receiver timestamp.

Example

use std::time::Duration;

use jiff::{SignedDuration, Timestamp, ToSpan};

let ts: Timestamp = "2024-02-28T00:00:00Z".parse()?;
assert_eq!(
    ts.checked_add(48.hours())?,
    "2024-03-01T00:00:00Z".parse()?,
);
assert_eq!(
    ts.checked_add(SignedDuration::from_hours(48))?,
    "2024-03-01T00:00:00Z".parse()?,
);
assert_eq!(
    ts.checked_add(Duration::from_secs(48 * 60 * 60))?,
    "2024-03-01T00:00:00Z".parse()?,
);

Trait Implementations

impl Clone for TimestampArithmetic

fn clone(&self) -> TimestampArithmetic

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TimestampArithmetic

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

Formats the value using the given formatter.

impl<'a> From<&'a Duration> for TimestampArithmetic

fn from(udur: &'a Duration) -> TimestampArithmetic

Converts to this type from the input type.

impl<'a> From<&'a SignedDuration> for TimestampArithmetic

fn from(sdur: &'a SignedDuration) -> TimestampArithmetic

Converts to this type from the input type.

impl<'a> From<&'a Span> for TimestampArithmetic

fn from(span: &'a Span) -> TimestampArithmetic

Converts to this type from the input type.

impl From<Duration> for TimestampArithmetic

fn from(udur: Duration) -> TimestampArithmetic

Converts to this type from the input type.

impl From<SignedDuration> for TimestampArithmetic

fn from(sdur: SignedDuration) -> TimestampArithmetic

Converts to this type from the input type.

impl From<Span> for TimestampArithmetic

fn from(span: Span) -> TimestampArithmetic

Converts to this type from the input type.

impl Copy for TimestampArithmetic