Crate dos_date_time 

The dos-date-time crate is an MS-DOS date and time library.

The DateTime is a type that represents MS-DOS date and time, which are packed 16-bit unsigned integer values that specify the date and time an MS-DOS file was last written to, and are used as timestamps such as FAT or ZIP file format.

Examples

Basic usage

DateTime can be converted from and to a type which represents time such as time::PrimitiveDateTime.

use core::time::Duration;

use dos_date_time::{
    DateTime,
    time::{
        PrimitiveDateTime,
        macros::{date, datetime, time},
    },
};

let dt = DateTime::MIN;
let dt = PrimitiveDateTime::from(dt);
assert_eq!(dt, datetime!(1980-01-01 00:00:00));

// <https://devblogs.microsoft.com/oldnewthing/20030905-02/?p=42653>.
let dt = dt + Duration::from_secs(722_805_900);
assert_eq!(dt, datetime!(2002-11-26 19:25:00));
let dt = DateTime::try_from(dt).unwrap();
assert_eq!(
    (dt.date().to_raw(), dt.time().to_raw()),
    (0b0010_1101_0111_1010, 0b1001_1011_0010_0000)
);

// The largest MS-DOS date and time.
assert_eq!(
    DateTime::from_date_time(date!(2107-12-31), time!(23:59:58)),
    Ok(DateTime::MAX)
);

Formatting and printing MS-DOS date and time

The Display trait for DateTime is implemented to show the value in the well-known RFC 3339 format. If you need a different date and time format, convert DateTime to a type which represents time such as time::PrimitiveDateTime.

use dos_date_time::{
    DateTime,
    time::{PrimitiveDateTime, format_description::well_known::Rfc2822},
};

let dt = DateTime::MIN;
assert_eq!(format!("{dt}"), "1980-01-01 00:00:00");

let dt = PrimitiveDateTime::from(dt)
    .as_utc()
    .format(&Rfc2822)
    .unwrap();
assert_eq!(format!("{dt}"), "Tue, 01 Jan 1980 00:00:00 +0000");

Re-exports

pub use chrono;chrono

pub use jiff;jiff

pub use time;

Modules

error

Error types for this crate.

Structs

Date

Date is a type that represents the MS-DOS date.

DateTime

DateTime is a type that combines a Date and a Time and represents MS-DOS date and time.

Time

Time is a type that represents the MS-DOS time.