Struct filetime::FileTime

pub struct FileTime { /* fields omitted */ }

A helper structure to represent a timestamp for a file.

The actual value contined within is platform-specific and does not have the same meaning across platforms, but comparisons and stringification can be significant among the same platform.

Methods

impl FileTime

fn zero() -> FileTime

Creates a new timestamp representing a 0 time.

Useful for creating the base of a cmp::max chain of times.

fn from_seconds_since_1970(seconds: u64, nanos: u32) -> FileTime

Creates a new instance of FileTime with a number of seconds and nanoseconds relative to January 1, 1970.

Note that this is typically the relative point that Unix time stamps are from, but on Windows the native time stamp is relative to January 1, 1601 so the return value of seconds from the returned FileTime instance may not be the same as that passed in.

fn from_last_modification_time(meta: &Metadata) -> FileTime

Creates a new timestamp from the last modification time listed in the specified metadata.

The returned value corresponds to the mtime field of stat on Unix platforms and the ftLastWriteTime field on Windows platforms.

fn from_last_access_time(meta: &Metadata) -> FileTime

Creates a new timestamp from the last access time listed in the specified metadata.

The returned value corresponds to the atime field of stat on Unix platforms and the ftLastAccessTime field on Windows platforms.

fn from_creation_time(meta: &Metadata) -> Option<FileTime>

Creates a new timestamp from the creation time listed in the specified metadata.

The returned value corresponds to the birthtime field of stat on Unix platforms and the ftCreationTime field on Windows platforms. Note that not all Unix platforms have this field available and may return None in some circumstances.

fn seconds(&self) -> u64

Returns the whole number of seconds represented by this timestamp.

Note that this value's meaning is platform specific. On Unix platform time stamps are typically relative to January 1, 1970, but on Windows platforms time stamps are relative to January 1, 1601.

fn seconds_relative_to_1970(&self) -> u64

Returns the whole number of seconds represented by this timestamp, relative to the Unix epoch start of January 1, 1970.

Note that this does not return the same value as seconds for Windows platforms as seconds are relative to a different date there.

fn nanoseconds(&self) -> u32

Returns the nanosecond precision of this timestamp.

The returned value is always less than one billion and represents a portion of a second forward from the seconds returned by the seconds method.

Trait Implementations

impl Eq for FileTime

impl PartialEq for FileTime

fn eq(&self, __arg_0: &FileTime) -> bool

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

fn ne(&self, __arg_0: &FileTime) -> bool

This method tests for !=.

impl Ord for FileTime

fn cmp(&self, __arg_0: &FileTime) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the minimum of two values.

impl PartialOrd for FileTime

fn partial_cmp(&self, __arg_0: &FileTime) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, __arg_0: &FileTime) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, __arg_0: &FileTime) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, __arg_0: &FileTime) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, __arg_0: &FileTime) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Debug for FileTime

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Copy for FileTime

impl Clone for FileTime

fn clone(&self) -> FileTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Hash for FileTime

fn hash<__H: Hasher>(&self, __arg_0: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Display for FileTime

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

Formats the value using the given formatter.