Struct nippy::Instant

pub struct Instant { /* fields omitted */ }

Describes an instant relative to the UNIX_EPOCH - 00:00:00 Coordinated Universal Time (UTC), Thursay, 1 January 1970 in seconds with the fractional part in nanoseconds.

If the Instant describes some moment prior to UNIX_EPOCH, both the secs and subsec_nanos components will be negative.

The sole purpose of this type is for retrieving the “current” time using the std::time module and for converting between the ntp timestamp formats. If you are interested in converting from unix time to some other more human readable format, perhaps see the chrono crate.

Example

Here is a demonstration of displaying the Instant in local time using the chrono crate:

extern crate chrono;
extern crate nippy;

use chrono::TimeZone;

fn main() {
    let unix_time = nippy::Instant::now();
    let local_time = chrono::Local.timestamp(unix_time.secs(), unix_time.subsec_nanos() as _);
    println!("{}", local_time);
}

Implementations

impl Instant

pub fn new(secs: i64, subsec_nanos: i32) -> Instant

Create a new Instant given its secs and subsec_nanos components.

To indicate a time following UNIX_EPOCH, both secs and subsec_nanos must be positive. To indicate a time prior to UNIX_EPOCH, both secs and subsec_nanos must be negative. Violating these invariants will result in a panic!.

pub fn now() -> Self

Uses std::time::SystemTime::now and std::time::UNIX_EPOCH to determine the current Instant.

Example

extern crate nippy;

fn main() {
    println!("{:?}", nippy::Instant::now());
}

pub fn secs(&self) -> i64

The “seconds” component of the Instant.

pub fn subsec_nanos(&self) -> i32

The fractional component of the Instant in nanoseconds.

Trait Implementations

impl Clone for Instant

fn clone(&self) -> Instant

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Instant

impl Debug for Instant

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

Formats the value using the given formatter.

impl From<Instant> for ShortFormat

fn from(t: Instant) -> Self

Performs the conversion.

impl From<Instant> for TimestampFormat

fn from(t: Instant) -> Self

Performs the conversion.

impl From<ShortFormat> for Instant

fn from(t: ShortFormat) -> Self

Performs the conversion.

impl From<TimestampFormat> for Instant

fn from(t: TimestampFormat) -> Self

Performs the conversion.