Crate nt_time 

The nt-time crate is a Windows file time library.

The FileTime is a type that represents the file time, which 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”, and is used as timestamps such as NTFS or 7z. Windows uses a file time to record when an application creates, accesses, or writes to a file.

Examples

Basic usage

FileTime can be converted from and to a type which represents time such as time::UtcDateTime. Addition and subtraction are also supported.

use core::time::Duration;

use nt_time::{
    FileTime,
    time::{UtcDateTime, macros::utc_datetime},
};

let ft = FileTime::NT_TIME_EPOCH;
assert_eq!(
    UtcDateTime::try_from(ft),
    Ok(utc_datetime!(1601-01-01 00:00:00))
);

let ft = ft + Duration::from_secs(11_644_473_600);
assert_eq!(UtcDateTime::try_from(ft), Ok(UtcDateTime::UNIX_EPOCH));
assert_eq!(ft.to_raw(), 116_444_736_000_000_000);

// The practical largest file time.
assert_eq!(FileTime::try_from(i64::MAX), Ok(FileTime::SIGNED_MAX));
// The theoretical largest file time.
assert_eq!(FileTime::new(u64::MAX), FileTime::MAX);

Conversion from and to other system times

FileTime can be converted from and to other system times such as Unix time or MS-DOS date and time.

Unix time

use nt_time::{
    FileTime,
    time::{UtcDateTime, macros::utc_datetime},
};

// `1970-01-01 00:00:00 UTC`.
let dt = UtcDateTime::UNIX_EPOCH;
assert_eq!(dt, utc_datetime!(1970-01-01 00:00:00));

// Convert to a `FileTime`.
let ft = FileTime::from_unix_time_secs(dt.unix_timestamp()).unwrap();
assert_eq!(ft, FileTime::UNIX_EPOCH);

// Back to Unix time.
let ut = ft.to_unix_time_secs();
assert_eq!(ut, 0);

MS-DOS date and time

use nt_time::{FileTime, dos_date_time::DateTime};

// `1980-01-01 00:00:00`.
let dt = DateTime::MIN;
assert_eq!(dt.to_string(), "1980-01-01 00:00:00");

// Convert to a `FileTime`.
let ft = FileTime::from(dt);
assert_eq!(ft, FileTime::new(119_600_064_000_000_000));

// Back to MS-DOS date and time.
let dt = DateTime::try_from(ft).unwrap();
assert_eq!(
    (dt.date().to_raw(), dt.time().to_raw()),
    (0b0000_0000_0010_0001, u16::MIN)
);

Formatting and printing the file time

The formatting traits for FileTime are implemented to show the underlying u64 value. If you need a human-readable date and time, convert FileTime to a type which represents time such as time::UtcDateTime.

use nt_time::{FileTime, time::UtcDateTime};

let ft = FileTime::NT_TIME_EPOCH;
assert_eq!(format!("{ft}"), "0");

let dt = UtcDateTime::try_from(ft).unwrap();
assert_eq!(format!("{dt}"), "1601-01-01 0:00:00.0 +00");

Re-exports

pub use chrono;chrono

pub use dos_date_time;dos-date-time

pub use jiff;jiff

pub use rand;rand

pub use serde;serde

pub use time;

Modules

error

Error types for this crate.

serde_withserde

Differential formats for Serde.

Structs

FileTime

FileTime is a type that represents a Windows file time.