dostime 2.0.0

A Rust crate that converts to and from MS DOS dates and times.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# dostime

This crate converts MS DOS times to and from various formats, including integers, byte arrays, and
types in external crates (see the features for more information).

This crate is `no_std` compatible.

An explanation of the date and time formats can be found
[here](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-dosdatetimetofiletime),
though the documentation for `DOSTime` and `DOSDate` also includes explantions for the format.

```rust
use dostime::{DOSDate, DOSTime, DOSDateTime};
use dostime::date::DateError;
use dostime::time::TimeError;
use dostime::datetime::DateTimeError;

// Valid dates and times can be constructed.
let date = DOSDate::new(2017, 4, 6).unwrap();           // 2017-04-06
let time = DOSTime::new(13, 24, 54).unwrap();           // 13:24:54
let datetime = DOSDateTime::new(2006, 4, 15, 1, 5, 34); // 2006-04-15 01:05:34

// Invalid dates and times can't be constructed and information about what is invalid is
// returned.
let invalid_month = DOSDate::new(1996, 13, 3).unwrap_err();
assert_eq!(invalid_month, DateError::InvalidMonth);

let invalid_second = DOSTime::new(1, 2, 60).unwrap_err();
assert_eq!(invalid_second, TimeError::InvalidSecond);

let invalid_day = DOSDateTime::new(2001, 4, 31, 6, 13, 12).unwrap_err();
assert_eq!(invalid_day, DateTimeError::DateError(DateError::InvalidDay));

// Dates and times can be converted to and from integers and arrays of bytes.
let int: u16 = date.into();
assert_eq!(int, 0x4A86);
assert_eq!(date, DOSDate::try_from(0x4A86).unwrap());

let bytes: [u8; 2] = time.into();
assert_eq!(bytes, [0x1B, 0x6B]);
assert_eq!(time, DOSTime::try_from([0x1B, 0x6B]).unwrap());
```

## Features

- `serde-1` - enables (de)serialization with Serde
- `time-1` - enables conversion to/from types in the `time` crate (`Date`, `Time`, and
`PrimitiveDateTime`)
- `chrono-1` - enables conversion to/from types in the `chrono` crate (`NaiveDate`, `NaiveTime`, and
`NaiveDateTime`)

## Future Work

If anyone thinks of something else that this crate should have or spots any bugs, let me know! I'll
see if I can add it. Alternatively, feel free to submit a pull request (or just fork it). I'll
review and approve it as soon as I can.