Struct aws_smithy_types::instant::Instant

pub struct Instant { /* fields omitted */ }

Instant in time.

Instant in time represented as seconds and sub-second nanos since the Unix epoch (January 1, 1970 at midnight UTC/GMT).

Implementations

impl Instant

pub fn from_epoch_seconds(epoch_seconds: i64) -> Self

Creates an Instant from a number of seconds since the Unix epoch.

pub fn from_fractional_seconds(epoch_seconds: i64, fraction: f64) -> Self

Creates an Instant from a number of seconds and a fractional second since the Unix epoch.

Example

assert_eq!(
    Instant::from_secs_and_nanos(1, 500_000_000u32),
    Instant::from_fractional_seconds(1, 0.5),
);

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

Creates an Instant from a number of seconds and sub-second nanos since the Unix epoch.

Example

assert_eq!(
    Instant::from_fractional_seconds(1, 0.5),
    Instant::from_secs_and_nanos(1, 500_000_000u32),
);

pub fn from_f64(epoch_seconds: f64) -> Self

Creates an Instant from an f64 representing the number of seconds since the Unix epoch.

Example

assert_eq!(
    Instant::from_fractional_seconds(1, 0.5),
    Instant::from_f64(1.5),
);

pub fn from_system_time(system_time: SystemTime) -> Self

Creates an Instant from a SystemTime.

pub fn from_str(s: &str, format: Format) -> Result<Self, DateParseError>

Parses an Instant from a string using the given format.

pub fn read(
    s: &str,
    format: Format,
    delim: char
) -> Result<(Self, &str), DateParseError>

Read 1 date of format from s, expecting either delim or EOF

Enable parsing multiple dates from the same string

pub fn to_chrono(self) -> DateTime<Utc>

Converts the Instant to a chrono DateTime<Utc>.

pub fn to_system_time(self) -> Option<SystemTime>

Convert this Instant to a SystemTime

Since SystemTime cannot represent times prior to the unix epoch, if this time is before 1/1/1970, this function will return None.

pub fn has_nanos(&self) -> bool

Returns true if sub-second nanos is greater than zero.

pub fn epoch_fractional_seconds(&self) -> f64

Returns the Instant value as an f64 representing the seconds since the Unix epoch.

pub fn epoch_seconds(&self) -> i64

Returns the epoch seconds component of the Instant.

Note: this does not include the sub-second nanos.

pub fn epoch_subsecond_nanos(&self) -> u32

Returns the sub-second nanos component of the Instant.

Note: this does not include the number of seconds since the epoch.

pub fn to_epoch_millis(self) -> Result<i64, ConversionError>

Converts the Instant to the number of milliseconds since the Unix epoch. This is fallible since Instant holds more precision than an i64, and will return a ConversionError for Instant values that can’t be converted.

pub fn from_epoch_millis(epoch_millis: i64) -> Instant

Converts number of milliseconds since the Unix epoch into an Instant.

pub fn fmt(&self, format: Format) -> String

Formats the Instant to a string using the given format.

Trait Implementations

impl Clone for Instant

fn clone(&self) -> Instant

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Instant

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

Formats the value using the given formatter.

impl From<DateTime<FixedOffset>> for Instant

fn from(value: DateTime<FixedOffset>) -> Instant

Performs the conversion.

impl From<DateTime<Utc>> for Instant

fn from(value: DateTime<Utc>) -> Instant

Performs the conversion.

impl PartialEq<Instant> for Instant

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

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

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

This method tests for !=.

impl Copy for Instant

impl StructuralPartialEq for Instant