Adding `fastdate` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add fastdate

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

fastdate = "0.3.36"

The fastdate library will be automatically available globally. Read the fastdate library documentation.

Back to the crate overview.

Readme

fastdate

fastdate of Any RFC3339Micro

way fastdate?

full test, Code testing coverage >= 99%
Powerful, easy to use
based on crate time

this date cartes is very fast(<= 50ns) including

offset_sec()
from_str("2022-12-13 11:12:14.123456")
now()
utc()
week_day()
to_string()
eq(),==
add(),sub()
format("YYYY-MM-DD hh:mm:ss.000000")
parse("YYYY-MM-DD,hh:mm:ss.000000","2022-12-13,11:12:14.123456")
set_offset()
unix_timestamp()
unix_timestamp_millis()
unix_timestamp_nano()
from_timestamp()
from_timestamp_millis()
from_timestamp_nano()
before(&date) -> bool
after(&date1) -> bool
from(v: SystemTime)
from(v: DateTime)
from(arg: Date)
from(arg: Time)
cmp(&self, other: &DateTime)/>/</>=/<= and more....

test bench_add                         ... bench:          14 ns/iter (+/- 0)
test bench_date_display                ... bench:          49 ns/iter (+/- 2)
test bench_date_from_str_iso_8601      ... bench:         129 ns/iter (+/- 6)
test bench_date_from_str_iso_8601_time ... bench:          69 ns/iter (+/- 2)
test bench_date_now_local              ... bench:          65 ns/iter (+/- 2)
test bench_date_parse_format           ... bench:         282 ns/iter (+/- 11)
test bench_date_utc                    ... bench:          49 ns/iter (+/- 2)
test bench_datetime_from_str           ... bench:         130 ns/iter (+/- 10)
test bench_eq                          ... bench:          10 ns/iter (+/- 0)
test bench_from_timestamp_millis       ... bench:          23 ns/iter (+/- 0)
test bench_get_micro                   ... bench:           0 ns/iter (+/- 0)
test bench_set_offset                  ... bench:          12 ns/iter (+/- 0)
test bench_timestamp                   ... bench:           2 ns/iter (+/- 0)

how use?

add to Cargo.tom dep

fastdate = "0.3"

use code

use fastdate::DateTime;
fn main(){
    //now with local time zone
    DateTime::now();
    //utc time now
    DateTime::utc();
    // add
    DateTime::now() + Duration::from_secs(1);
    // sub
    DateTime::now() - Duration::from_secs(1);
    //parse allow token = ["YYYY","MM","DD","hh","mm","ss",".000000","+00:00","Z"]
    fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000000Z", "2022-12-13 11:12:14.123456789Z").unwrap();
    fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000000+00:00", "2022-12-13 11:12:14.123456789+06:00").unwrap();
    DateTime::parse("hh:mm:ss.000000,YYYY-MM-DD","11:12:14.123456,2022-12-13").unwrap();
    //format allow token = ["YYYY","MM","DD","hh","mm","ss",".000000","+00:00","Z"]
     let dt = fastdate::DateTime::from((
        Date {
            day: 1,
            mon: 1,
            year: 2000,
        },
        Time {
            nano: 1233,
            sec: 11,
            minute: 1,
            hour: 1,
        },
    ));
    let str:String = dt.format("YYYY-MM-DD/hh/mm/ss");
    //befor,after
    let date1 = DateTime::from_str("2022-12-12 00:00:00").unwrap();
    let date2 = DateTime::from_str("2022-12-12 01:00:00").unwrap();
    assert_eq!(date2.after(&date1), true);
    assert_eq!(date1.before(&date2), true);
    //from str
    let datetime=DateTime::from_str("1234-12-13 11:12:13.123456");
    //from str time zone
    let datetime=DateTime::from_str("1234-12-13 11:12:13.123456+08:00");
    let datetime=DateTime::from_str("1234-12-13 11:12:13.123456Z");
    //to_string()
    let s = datetime.to_string();//1234-12-13 11:12:13.123456
    //unix_timestamp
    let timestamp = DateTime::now().unix_timestamp();
    //from unix_timestamp
    let datetime = DateTime::from_timestamp(timestamp);
    //unix_timestamp_millis
    let timestamp = DateTime::now().unix_timestamp_millis();
    //from unix millis
    let datetime = DateTime::from_timestamp_millis(timestamp);
    //unix_timestamp_nano
    let timestamp = DateTime::now().unix_timestamp_nano();
    //from unix_timestamp_nano
    let datetime = DateTime::from_timestamp_nano(timestamp);
    //sum Greenwich Mean Time (GMT) from datetime
    let time_gmt = DateTime::now().sub(Duration::from_secs(offset_sec() as u64));
}

Adding fastdate library as a dependency

Adding `fastdate` library as a dependency