Crate qsv_dateparser

Expand description

A rust library for parsing date strings in commonly used formats. Parsed date will be returned as chrono’s DateTime<Utc>.

Quick Start

Use str’s parse method:

use chrono::prelude::*;
use qsv_dateparser::DateTimeUtc;
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    assert_eq!(
        "2021-05-14 18:51 PDT".parse::<DateTimeUtc>()?.0,
        Utc.ymd(2021, 5, 15).and_hms(1, 51, 0),
    );
    Ok(())
}

Accepted date formats

use qsv_dateparser::DateTimeUtc;

let accepted = vec![
    // rfc3339
    "2021-05-01T01:17:02.604456Z",
    "2017-11-25T22:34:50Z",
    // rfc2822
    "Wed, 02 Jun 2021 06:31:39 GMT",
    // yyyy-mm-dd hh:mm:ss
    "2014-04-26 05:24:37 PM",
    "2021-04-30 21:14",
    "2021-04-30 21:14:10",
    "2021-04-30 21:14:10.052282",
    "2014-04-26 17:24:37.123",
    "2014-04-26 17:24:37.3186369",
    "2012-08-03 18:31:59.257000000",
    // yyyy-mm-dd hh:mm:ss z
    "2017-11-25 13:31:15 PST",
    "2017-11-25 13:31 PST",
    "2014-12-16 06:20:00 UTC",
    "2014-12-16 06:20:00 GMT",
    "2014-04-26 13:13:43 +0800",
    "2014-04-26 13:13:44 +09:00",
    "2012-08-03 18:31:59.257000000 +0000",
    "2015-09-30 18:48:56.35272715 UTC",
    // yyyy-mm-dd
    "2021-02-21",
    // yyyy-mm-dd z
    "2021-02-21 PST",
    "2021-02-21 UTC",
    "2020-07-20+08:00",
    // Mon dd, yyyy, hh:mm:ss
    "May 8, 2009 5:57:51 PM",
    "September 17, 2012 10:09am",
    "September 17, 2012, 10:10:09",
    // Mon dd, yyyy hh:mm:ss z
    "May 02, 2021 15:51:31 UTC",
    "May 02, 2021 15:51 UTC",
    "May 26, 2021, 12:49 AM PDT",
    "September 17, 2012 at 10:09am PST",
    // yyyy-mon-dd
    "2021-Feb-21",
    // Mon dd, yyyy
    "May 25, 2021",
    "oct 7, 1970",
    "oct 7, 70",
    "oct. 7, 1970",
    "oct. 7, 70",
    "October 7, 1970",
    // dd Mon yyyy hh:mm:ss
    "12 Feb 2006, 19:17",
    "12 Feb 2006 19:17",
    "14 May 2019 19:11:40.164",
    // dd Mon yyyy
    "7 oct 70",
    "7 oct 1970",
    "03 February 2013",
    "1 July 2013",
    // mm/dd/yyyy hh:mm:ss
    "4/8/2014 22:05",
    "04/08/2014 22:05",
    "4/8/14 22:05",
    "04/2/2014 03:00:51",
    "8/8/1965 12:00:00 AM",
    "8/8/1965 01:00:01 PM",
    "8/8/1965 01:00 PM",
    "8/8/1965 1:00 PM",
    "8/8/1965 12:00 AM",
    "4/02/2014 03:00:51",
    "03/19/2012 10:11:59",
    "03/19/2012 10:11:59.3186369",
    // mm/dd/yyyy
    "3/31/2014",
    "03/31/2014",
    "08/21/71",
    "8/1/71",
    // yyyy/mm/dd hh:mm:ss
    "2014/4/8 22:05",
    "2014/04/08 22:05",
    "2014/04/2 03:00:51",
    "2014/4/02 03:00:51",
    "2012/03/19 10:11:59",
    "2012/03/19 10:11:59.3186369",
    // yyyy/mm/dd
    "2014/3/31",
    "2014/03/31",
];

for date_str in accepted {
    let result = date_str.parse::<DateTimeUtc>();
    assert!(result.is_ok())
}

DMY Format

It also accepts dates in DMY format with parse_with_preference, and the prefer_dmy parameter set to true.

use qsv_dateparser::parse_with_preference;

let accepted = vec![
    // dd/mm/yyyy
    "31/12/2020",
    "12/10/2019",
    "03/06/2018",
    "27/06/68",
    // dd/mm/yyyy hh:mm:ss
    "4/8/2014 22:05",
    "04/08/2014 22:05",
    "4/8/14 22:05",
    "04/2/2014 03:00:51",
    "8/8/1965 12:00:00 AM",
    "8/8/1965 01:00:01 PM",
    "8/8/1965 01:00 PM",
    "31/12/22 15:00"
];

for date_str in accepted {
    let result = parse_with_preference(date_str, true);
    assert!(result.is_ok());
}

Modules

datetime

Datetime string parser

timezone

Timezone offset string parser

DateTimeUtc is an alias for chrono’s DateTime<UTC>. It implements std::str::FromStr’s from_str method, and it makes str’s parse method to understand the accepted date formats from this crate.

Functions

parse

This function tries to recognize the input datetime string with a list of accepted formats. When timezone is not provided, this function assumes it’s a chrono::Local datetime. For custom timezone, use parse_with_timezone() instead.If all options are exhausted, parse() will return an error to let the caller know that no formats were matched.

parse_with

Similar to parse() and parse_with_timezone(), this function takes a datetime string, a custom chrono::TimeZone and a default naive time. In addition to assuming timezone when it’s not given in datetime string, this function also use provided default naive time in parsed chrono::DateTime.

parse_with_preference

Similar to parse(), this function takes a datetime string and a boolean dmy_preference. When dmy_preference is true, it will parse strings using the DMY format. Otherwise, it parses them using an MDY format.

parse_with_timezone