Struct nt_time::FileTime

pub struct FileTime(_);

FileTime is a type that represents the Windows NT system time.

This is a 64-bit unsigned integer value that represents the number of 100-nanosecond intervals that have elapsed since “1601-01-01 00:00:00 UTC”.

Implementations

impl FileTime

pub const NT_EPOCH: Self = _

The NT time epoch.

This is defined as “1601-01-01 00:00:00 UTC”.

Examples

assert_eq!(
    OffsetDateTime::try_from(FileTime::NT_EPOCH).unwrap(),
    datetime!(1601-01-01 00:00 UTC)
);

pub const MAX: Self = _

The largest value that can be represented by the Windows NT system time.

This is “+60056-05-28 05:36:10.955161500 UTC”.

Examples

assert_eq!(
    OffsetDateTime::try_from(FileTime::MAX).unwrap(),
    datetime!(+60056-05-28 05:36:10.955_161_500 UTC)
);

pub const fn new(time: u64) -> Self

Creates a new FileTime with the given Windows NT system time.

Examples

assert_eq!(FileTime::new(u64::MIN), FileTime::NT_EPOCH);
assert_eq!(FileTime::new(u64::MAX), FileTime::MAX);

pub const fn as_u64(self) -> u64

Converts a FileTime to the Windows NT system time.

Examples

assert_eq!(FileTime::NT_EPOCH.as_u64(), u64::MIN);
assert_eq!(FileTime::MAX.as_u64(), u64::MAX);

pub fn checked_add(self, duration: Duration) -> Option<Self>

Computes self + duration, returning None if overflow occurred.

Examples

assert_eq!(
    FileTime::NT_EPOCH.checked_add(Duration::from_nanos(1)),
    Some(FileTime::NT_EPOCH)
);
assert_eq!(
    FileTime::NT_EPOCH.checked_add(Duration::from_nanos(100)),
    Some(FileTime::new(1))
);

assert_eq!(FileTime::MAX.checked_add(Duration::from_nanos(100)), None);

pub fn checked_sub(self, duration: Duration) -> Option<Self>

Computes self - duration, returning None if the result would be negative or if overflow occurred.

Examples

assert_eq!(
    FileTime::MAX.checked_sub(Duration::from_nanos(1)),
    Some(FileTime::MAX)
);
assert_eq!(
    FileTime::MAX.checked_sub(Duration::from_nanos(100)),
    Some(FileTime::new(u64::MAX - 1))
);

assert_eq!(
    FileTime::NT_EPOCH.checked_sub(Duration::from_nanos(100)),
    None
);

pub fn saturating_add(self, duration: Duration) -> Self

Computes self + duration, returning FileTime::MAX if overflow occurred.

Examples

assert_eq!(
    FileTime::NT_EPOCH.saturating_add(Duration::from_nanos(1)),
    FileTime::NT_EPOCH
);
assert_eq!(
    FileTime::NT_EPOCH.saturating_add(Duration::from_nanos(100)),
    FileTime::new(1)
);

assert_eq!(
    FileTime::MAX.saturating_add(Duration::from_nanos(100)),
    FileTime::MAX
);

pub fn saturating_sub(self, duration: Duration) -> Self

Computes self - duration, returning FileTime::NT_EPOCH if the result would be negative or if overflow occurred.

Examples

assert_eq!(
    FileTime::MAX.saturating_sub(Duration::from_nanos(1)),
    FileTime::MAX
);
assert_eq!(
    FileTime::MAX.saturating_sub(Duration::from_nanos(100)),
    FileTime::new(u64::MAX - 1)
);

assert_eq!(
    FileTime::NT_EPOCH.saturating_sub(Duration::from_nanos(100)),
    FileTime::NT_EPOCH
);

Trait Implementations

impl Add<Duration> for FileTime

type Output = FileTime

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

impl AddAssign<Duration> for FileTime

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

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 Debug for FileTime

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

Formats the value using the given formatter.

impl Default for FileTime

fn default() -> Self

Returns the default value of “1601-01-01 00:00:00 UTC”.

Examples

assert_eq!(FileTime::default(), FileTime::NT_EPOCH);

impl Display for FileTime

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

Formats the value using the given formatter.

impl From<FileTime> for u64

fn from(time: FileTime) -> Self

Converts a FileTime to the Windows NT system time.

Examples

assert_eq!(u64::from(FileTime::NT_EPOCH), u64::MIN);
assert_eq!(u64::from(FileTime::MAX), u64::MAX);

impl From<u64> for FileTime

fn from(time: u64) -> Self

Converts the Windows NT system time to a FileTime.

Examples

assert_eq!(FileTime::from(u64::MIN), FileTime::NT_EPOCH);
assert_eq!(FileTime::from(u64::MAX), FileTime::MAX);

impl Hash for FileTime

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 Ord for FileTime

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<FileTime> for FileTime

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<FileTime> for FileTime

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

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

fn lt(&self, other: &Rhs) -> bool

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

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

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

fn ge(&self, other: &Rhs) -> bool

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

impl Sub<Duration> for FileTime

type Output = FileTime

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Sub<FileTime> for FileTime

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl SubAssign<Duration> for FileTime

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl TryFrom<FileTime> for OffsetDateTime

fn try_from(time: FileTime) -> Result<Self, Self::Error>

Converts a FileTime to a OffsetDateTime.

Errors

Returns Err if the large-dates feature is disabled and time is out of range of OffsetDateTime.

type Error = OffsetDateTimeRangeError

The type returned in the event of a conversion error.

impl TryFrom<FileTime> for SystemTime

Available on crate feature std only.

fn try_from(time: FileTime) -> Result<Self, Self::Error>

Converts a FileTime to a SystemTime.

Errors

Returns Err if the large-dates feature is disabled and time is out of range of OffsetDateTime.

type Error = OffsetDateTimeRangeError

The type returned in the event of a conversion error.

impl TryFrom<OffsetDateTime> for FileTime

fn try_from(dt: OffsetDateTime) -> Result<Self, Self::Error>

Converts a OffsetDateTime to a FileTime.

Errors

Returns Err if dt is out of range of the Windows NT system time.

type Error = FileTimeRangeError

The type returned in the event of a conversion error.

impl TryFrom<SystemTime> for FileTime

Available on crate feature std only.

fn try_from(time: SystemTime) -> Result<Self, Self::Error>

Converts a SystemTime to a FileTime.

Errors

Returns Err if time is out of range of the Windows NT system time.

type Error = FileTimeRangeError

The type returned in the event of a conversion error.

impl Copy for FileTime

impl Eq for FileTime

impl StructuralEq for FileTime

impl StructuralPartialEq for FileTime