Struct nt_time::FileTime

pub struct FileTime(_);

FileTime is a type that represents a Windows file 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_TIME_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_TIME_EPOCH).unwrap(),
    PrimitiveDateTime::new(
        Date::from_calendar_date(1601, Month::January, 1).unwrap(),
        Time::MIDNIGHT
    )
    .assume_utc()
);

pub const UNIX_EPOCH: Self = _

The Unix epoch.

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

Examples

assert_eq!(
    OffsetDateTime::try_from(FileTime::UNIX_EPOCH).unwrap(),
    OffsetDateTime::UNIX_EPOCH
);

pub const MAX: Self = _

The largest value that can be represented by the file time.

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

Examples

assert_eq!(
    OffsetDateTime::try_from(FileTime::MAX).unwrap(),
    PrimitiveDateTime::new(
        Date::from_calendar_date(60056, Month::May, 28).unwrap(),
        Time::from_hms_nano(5, 36, 10, 955_161_500).unwrap()
    )
    .assume_utc()
);

pub fn now() -> Self

Available on crate feature std only.

Returns the file time corresponding to “now”.

Panics

Panics if “now” is out of range for the file time.

Examples

let now = FileTime::now();

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

Creates a new FileTime with the given file time.

Examples

assert_eq!(FileTime::new(u64::MIN), FileTime::NT_TIME_EPOCH);
assert_eq!(FileTime::new(116_444_736_000_000_000), FileTime::UNIX_EPOCH);
assert_eq!(FileTime::new(u64::MAX), FileTime::MAX);

pub const fn as_u64(self) -> u64

Returns the contents of this FileTime as the underlying u64 value.

Examples

assert_eq!(FileTime::NT_TIME_EPOCH.as_u64(), u64::MIN);
assert_eq!(FileTime::UNIX_EPOCH.as_u64(), 116_444_736_000_000_000);
assert_eq!(FileTime::MAX.as_u64(), u64::MAX);

pub fn to_unix_time(self) -> i64

Returns Unix time represents the same date and time as this FileTime.

Examples

assert_eq!(FileTime::NT_TIME_EPOCH.to_unix_time(), -11_644_473_600);
assert_eq!(FileTime::UNIX_EPOCH.to_unix_time(), i64::default());
assert_eq!(FileTime::MAX.to_unix_time(), 1_833_029_933_770);

pub fn to_unix_time_nanos(self) -> i128

Returns Unix time in nanoseconds represents the same date and time as this FileTime.

Examples

assert_eq!(
    FileTime::NT_TIME_EPOCH.to_unix_time_nanos(),
    -11_644_473_600_000_000_000
);
assert_eq!(FileTime::UNIX_EPOCH.to_unix_time_nanos(), i128::default());
assert_eq!(
    FileTime::MAX.to_unix_time_nanos(),
    1_833_029_933_770_955_161_500
);

pub fn from_unix_time(time: i64) -> Result<Self, FileTimeRangeError>

Creates a FileTime with the given Unix time.

Errors

Returns Err if time is out of range for the file time.

Examples

assert_eq!(
    FileTime::from_unix_time(-11_644_473_600).unwrap(),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::from_unix_time(i64::default()).unwrap(),
    FileTime::UNIX_EPOCH
);
assert_eq!(
    FileTime::from_unix_time(1_833_029_933_770).unwrap(),
    FileTime::MAX - Duration::from_nanos(955_161_500)
);

assert!(FileTime::from_unix_time(-11_644_473_601).is_err());
assert!(FileTime::from_unix_time(1_833_029_933_771).is_err());

pub fn from_unix_time_nanos(time: i128) -> Result<Self, FileTimeRangeError>

Creates a FileTime with the given Unix time in nanoseconds.

Errors

Returns Err if time is out of range for the file time.

Examples

assert_eq!(
    FileTime::from_unix_time_nanos(-11_644_473_600_000_000_000).unwrap(),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::from_unix_time_nanos(i128::default()).unwrap(),
    FileTime::UNIX_EPOCH
);
assert_eq!(
    FileTime::from_unix_time_nanos(1_833_029_933_770_955_161_500).unwrap(),
    FileTime::MAX
);

assert!(FileTime::from_unix_time_nanos(-11_644_473_600_000_000_100).is_err());
assert!(FileTime::from_unix_time_nanos(1_833_029_933_770_955_161_501).is_err());

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

Computes self + rhs, returning None if overflow occurred.

Examples

assert_eq!(
    FileTime::NT_TIME_EPOCH.checked_add(Duration::from_nanos(1)),
    Some(FileTime::NT_TIME_EPOCH)
);
assert_eq!(
    FileTime::NT_TIME_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, rhs: Duration) -> Option<Self>

Computes self - rhs, 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_TIME_EPOCH.checked_sub(Duration::from_nanos(100)),
    None
);

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

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

Examples

assert_eq!(
    FileTime::NT_TIME_EPOCH.saturating_add(Duration::from_nanos(1)),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::NT_TIME_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, rhs: Duration) -> Self

Computes self - rhs, returning FileTime::NT_TIME_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_TIME_EPOCH.saturating_sub(Duration::from_nanos(100)),
    FileTime::NT_TIME_EPOCH
);

pub const fn to_be_bytes(self) -> [u8; 8]

Returns the memory representation of this FileTime as a byte array in big-endian byte order.

Examples

assert_eq!(FileTime::NT_TIME_EPOCH.to_be_bytes(), [u8::MIN; 8]);
assert_eq!(
    FileTime::UNIX_EPOCH.to_be_bytes(),
    [0x01, 0x9d, 0xb1, 0xde, 0xd5, 0x3e, 0x80, 0x00]
);
assert_eq!(FileTime::MAX.to_be_bytes(), [u8::MAX; 8]);

pub const fn to_le_bytes(self) -> [u8; 8]

Returns the memory representation of this FileTime as a byte array in little-endian byte order.

Examples

assert_eq!(FileTime::NT_TIME_EPOCH.to_le_bytes(), [u8::MIN; 8]);
assert_eq!(
    FileTime::UNIX_EPOCH.to_le_bytes(),
    [0x00, 0x80, 0x3e, 0xd5, 0xde, 0xb1, 0x9d, 0x01]
);
assert_eq!(FileTime::MAX.to_le_bytes(), [u8::MAX; 8]);

pub const fn from_be_bytes(bytes: [u8; 8]) -> Self

Creates a native endian FileTime value from its representation as a byte array in big-endian.

Examples

assert_eq!(
    FileTime::from_be_bytes([u8::MIN; 8]),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::from_be_bytes([0x01, 0x9d, 0xb1, 0xde, 0xd5, 0x3e, 0x80, 0x00]),
    FileTime::UNIX_EPOCH
);
assert_eq!(FileTime::from_be_bytes([u8::MAX; 8]), FileTime::MAX);

pub const fn from_le_bytes(bytes: [u8; 8]) -> Self

Creates a native endian FileTime value from its representation as a byte array in little-endian.

Examples

assert_eq!(
    FileTime::from_le_bytes([u8::MIN; 8]),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::from_le_bytes([0x00, 0x80, 0x3e, 0xd5, 0xde, 0xb1, 0x9d, 0x01]),
    FileTime::UNIX_EPOCH
);
assert_eq!(FileTime::from_le_bytes([u8::MAX; 8]), FileTime::MAX);

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 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 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”.

Equivalent to FileTime::NT_TIME_EPOCH except that it is not callable in const contexts.

Examples

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

impl<'de> Deserialize<'de> for FileTime

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserializes a FileTime from the given Serde deserializer.

This deserializes from its underlying u64 representation.

Examples

assert_eq!(
    serde_json::from_str::<FileTime>("116444736000000000").unwrap(),
    FileTime::UNIX_EPOCH
);

assert_eq!(
    serde_json::from_str::<Option<FileTime>>("116444736000000000").unwrap(),
    Some(FileTime::UNIX_EPOCH)
);
assert_eq!(
    serde_json::from_str::<Option<FileTime>>("null").unwrap(),
    None
);

impl Display for FileTime

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

Shows the underlying u64 value of this FileTime.

Examples

assert_eq!(format!("{}", FileTime::NT_TIME_EPOCH), "0");
assert_eq!(format!("{}", FileTime::UNIX_EPOCH), "116444736000000000");
assert_eq!(format!("{}", FileTime::MAX), "18446744073709551615");

impl From<FileTime> for DateTime<Utc>

Available on crate feature chrono only.

fn from(time: FileTime) -> Self

Converts a FileTime to a DateTime<Utc>.

Examples

assert_eq!(
    DateTime::<Utc>::from(FileTime::NT_TIME_EPOCH),
    Utc.with_ymd_and_hms(1601, 1, 1, 0, 0, 0).unwrap()
);
assert_eq!(
    DateTime::<Utc>::from(FileTime::UNIX_EPOCH),
    Utc.timestamp_opt(0, 0).unwrap()
);

impl From<FileTime> for SystemTime

Available on crate feature std only.

fn from(time: FileTime) -> Self

Converts a FileTime to a SystemTime.

Panics

Panics if the resulting point in time cannot be represented by the underlying OS-specific time format.

Examples

assert_eq!(
    SystemTime::from(FileTime::NT_TIME_EPOCH),
    SystemTime::UNIX_EPOCH - Duration::from_secs(11_644_473_600)
);
assert_eq!(
    SystemTime::from(FileTime::UNIX_EPOCH),
    SystemTime::UNIX_EPOCH
);

impl From<FileTime> for u64

fn from(time: FileTime) -> Self

Converts a FileTime to the file time.

Equivalent to FileTime::as_u64 except that it is not callable in const contexts.

Examples

assert_eq!(u64::from(FileTime::NT_TIME_EPOCH), u64::MIN);
assert_eq!(u64::from(FileTime::UNIX_EPOCH), 116_444_736_000_000_000);
assert_eq!(u64::from(FileTime::MAX), u64::MAX);

impl From<u64> for FileTime

fn from(time: u64) -> Self

Converts the file time to a FileTime.

Equivalent to FileTime::new except that it is not callable in const contexts.

Examples

assert_eq!(FileTime::from(u64::MIN), FileTime::NT_TIME_EPOCH);
assert_eq!(
    FileTime::from(116_444_736_000_000_000),
    FileTime::UNIX_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<DateTime<Utc>> for FileTime

Available on crate feature chrono only.

fn eq(&self, other: &DateTime<Utc>) -> 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 PartialEq<FileTime> for DateTime<Utc>

Available on crate feature chrono only.

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 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 PartialEq<FileTime> for OffsetDateTime

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 PartialEq<FileTime> for SystemTime

Available on crate feature std only.

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 PartialEq<OffsetDateTime> for FileTime

fn eq(&self, other: &OffsetDateTime) -> 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 PartialEq<SystemTime> for FileTime

Available on crate feature std only.

fn eq(&self, other: &SystemTime) -> 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<DateTime<Utc>> for FileTime

Available on crate feature chrono only.

fn partial_cmp(&self, other: &DateTime<Utc>) -> 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 PartialOrd<FileTime> for DateTime<Utc>

Available on crate feature chrono only.

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 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 PartialOrd<FileTime> for OffsetDateTime

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 PartialOrd<FileTime> for SystemTime

Available on crate feature std only.

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 PartialOrd<OffsetDateTime> for FileTime

fn partial_cmp(&self, other: &OffsetDateTime) -> 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 PartialOrd<SystemTime> for FileTime

Available on crate feature std only.

fn partial_cmp(&self, other: &SystemTime) -> 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 Serialize for FileTime

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serializes a FileTime into the given Serde serializer.

This serializes using the underlying u64 format.

Examples

assert_eq!(
    serde_json::to_string(&FileTime::UNIX_EPOCH).unwrap(),
    "116444736000000000"
);

assert_eq!(
    serde_json::to_string(&Some(FileTime::UNIX_EPOCH)).unwrap(),
    "116444736000000000"
);
assert_eq!(serde_json::to_string(&None::<FileTime>).unwrap(), "null");

impl Sub<DateTime<Utc>> for FileTime

Available on crate feature chrono only.

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

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<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 DateTime<Utc>

Available on crate feature chrono only.

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, rhs: FileTime) -> 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 Sub<FileTime> for OffsetDateTime

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<FileTime> for SystemTime

Available on crate feature std only.

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<OffsetDateTime> for FileTime

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<SystemTime> for FileTime

Available on crate feature std only.

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for FileTime

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl SubAssign<Duration> for FileTime

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl TryFrom<DateTime<Utc>> for FileTime

Available on crate feature chrono only.

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

Converts a DateTime<Utc> to a FileTime.

Errors

Returns Err if dt is out of range for the file time.

Examples

assert_eq!(
    FileTime::try_from(Utc.with_ymd_and_hms(1601, 1, 1, 0, 0, 0).unwrap()).unwrap(),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::try_from(Utc.timestamp_opt(0, 0).unwrap()).unwrap(),
    FileTime::UNIX_EPOCH
);

assert!(FileTime::try_from(
    Utc.with_ymd_and_hms(1601, 1, 1, 0, 0, 0).unwrap() - Duration::nanoseconds(1)
)
.is_err());

assert!(FileTime::try_from(
    Utc.with_ymd_and_hms(60056, 5, 28, 5, 36, 10).unwrap()
        + Duration::nanoseconds(955_161_500)
        + Duration::nanoseconds(100)
)
.is_err());

type Error = FileTimeRangeError

The type returned in the event of a conversion error.

impl TryFrom<FileTime> for OffsetDateTime

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

Converts a FileTime to a OffsetDateTime.

Errors

Returns Err if time is out of range for OffsetDateTime.

Examples

assert_eq!(
    OffsetDateTime::try_from(FileTime::NT_TIME_EPOCH).unwrap(),
    PrimitiveDateTime::new(
        Date::from_calendar_date(1601, Month::January, 1).unwrap(),
        Time::MIDNIGHT
    )
    .assume_utc()
);
assert_eq!(
    OffsetDateTime::try_from(FileTime::UNIX_EPOCH).unwrap(),
    OffsetDateTime::UNIX_EPOCH
);

With the large-dates feature disabled, returns Err if the file time represents after “9999-12-31 23:59:59.999999900 UTC”:

assert!(OffsetDateTime::try_from(FileTime::new(2_650_467_744_000_000_000)).is_err());

With the large-dates feature enabled, this always succeeds:

assert_eq!(
    OffsetDateTime::try_from(FileTime::new(2_650_467_744_000_000_000)).unwrap(),
    PrimitiveDateTime::new(
        Date::from_calendar_date(10000, Month::January, 1).unwrap(),
        Time::MIDNIGHT
    )
    .assume_utc()
);
assert_eq!(
    OffsetDateTime::try_from(FileTime::MAX).unwrap(),
    PrimitiveDateTime::new(
        Date::from_calendar_date(60056, Month::May, 28).unwrap(),
        Time::from_hms_nano(5, 36, 10, 955_161_500).unwrap()
    )
    .assume_utc()
);

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 for the file time.

Examples

assert_eq!(
    FileTime::try_from(
        PrimitiveDateTime::new(
            Date::from_calendar_date(1601, Month::January, 1).unwrap(),
            Time::MIDNIGHT
        )
        .assume_utc()
    )
    .unwrap(),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::try_from(OffsetDateTime::UNIX_EPOCH).unwrap(),
    FileTime::UNIX_EPOCH
);

assert!(FileTime::try_from(
    PrimitiveDateTime::new(
        Date::from_calendar_date(1601, Month::January, 1).unwrap(),
        Time::MIDNIGHT
    )
    .assume_utc()
        - Duration::NANOSECOND
)
.is_err());

With the large-dates feature enabled, returns Err if OffsetDateTime represents after “+60056-05-28 05:36:10.955161500 UTC”:

assert!(FileTime::try_from(
    PrimitiveDateTime::new(
        Date::from_calendar_date(60056, Month::May, 28).unwrap(),
        Time::from_hms_nano(5, 36, 10, 955_161_500).unwrap()
    )
    .assume_utc()
        + Duration::nanoseconds(100)
)
.is_err());

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 for the file time.

Examples

assert_eq!(
    FileTime::try_from(SystemTime::UNIX_EPOCH - Duration::from_secs(11_644_473_600)).unwrap(),
    FileTime::NT_TIME_EPOCH
);
assert_eq!(
    FileTime::try_from(SystemTime::UNIX_EPOCH).unwrap(),
    FileTime::UNIX_EPOCH
);

assert!(FileTime::try_from(
    SystemTime::UNIX_EPOCH - Duration::from_nanos(11_644_473_600_000_000_100)
)
.is_err());

assert!(FileTime::try_from(
    SystemTime::UNIX_EPOCH + Duration::new(1_833_029_933_770, 955_161_600)
)
.is_err());

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