nt-time

nt-time is a Windows file time library for Rust.

A Windows file time 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 and 7z. Windows uses a file time to record when an application creates, accesses, or writes to a file.

[!IMPORTANT] Note that many environments, such as the Win32 API, may limit the largest value of the file time to "+30828-09-14 02:48:05.477580700 UTC", which is equal to the largest value of a 64-bit signed integer type when represented as an underlying integer value. This is the largest file time accepted by the FileTimeToSystemTime function of the Win32 API.

Usage

Run the following command in your project directory:

cargo add nt-time

Crate features

chrono

Enables the chrono crate.

jiff

Enables the jiff crate.

large-dates

Enables the large-dates feature of the time crate.

rand

Enables the rand crate.

serde

Enables the serde crate.

serde-human-readable

Allows Serde representations to use a human-readable format. This implicitly enables the serde feature.

std

Enables features that depend on the standard library. This is enabled by default.

no_std support

This supports no_std mode. Disables the default feature to enable this.

Documentation

See the documentation for more details.

Minimum supported Rust version

The minimum supported Rust version (MSRV) of this library is v1.85.0.

Source code

The upstream repository is available at https://github.com/sorairolake/nt-time.git.

Changelog

Please see CHANGELOG.adoc.

Contributing

Please see CONTRIBUTING.adoc.

License

Copyright (C) 2023 Shun Sakai (see AUTHORS.adoc)

This library is distributed under the terms of either the Apache License 2.0 or the MIT License.

This project is compliant with version 3.3 of the REUSE Specification. See copyright notices of individual files for more details on copyright and licensing information.