2 releases

0.1.1 Sep 8, 2023
0.1.0 Sep 8, 2023

#2283 in Parser implementations

Download history 138/week @ 2024-03-13 139/week @ 2024-03-20 85/week @ 2024-03-27 201/week @ 2024-04-03 255/week @ 2024-04-10 468/week @ 2024-04-17 215/week @ 2024-04-24 150/week @ 2024-05-01 120/week @ 2024-05-08 442/week @ 2024-05-15 306/week @ 2024-05-22 344/week @ 2024-05-29 442/week @ 2024-06-05 157/week @ 2024-06-12 424/week @ 2024-06-19 307/week @ 2024-06-26

1,429 downloads per month
Used in 6 crates (3 directly)

Apache-2.0

16KB
326 lines

flexible-time

crates.io docs.rs CI

Time formats can be tricky. And parsing them even more so. However, in some cases you just don't want to bother the user with that. Especially when it comes command line applications.

The Problem

I need a command line argument --since, which allows the user to provide a year, or specific minute of a day. Either one is fine.

This crate can do it.

Filling the gaps

The timestamp will be parsed, but have gaps (like month, day). As can be different expectations on how to fill those gaps. The primary motivation for this crate was a "since" timestamp, so the strategy for that would be to fill missing components with the minimal value. That's implemented using the StartTimestamp.

Currently, there is no timezone handling, it defaults to UTC.

Formats

For timestamps, the following formats can be used:

Input Start timestamp
2023 2023-01-01 00:00:00 UTC
2023-02 2023-02-01 00:00:00 UTC
2023-02-03 2023-02-03 00:00:00 UTC
2023-02-03 16 2023-02-03 16:00:00 UTC
2023-02-03 16:05 2023-02-03 16:05:00 UTC
2023-02-03 16:05:06 2023-02-03 16:05:06 UTC

Dependencies

~750KB
~13K SLoC