#ms #converter #milliseconds

ms-converter

Fast abstraction for converting human-like times into milliseconds

14 releases (1 stable)

✓ Uses Rust 2018 edition

new 1.0.0 Mar 25, 2020
0.7.4 Mar 24, 2020
0.6.0 Mar 17, 2020
0.5.1 Mar 16, 2020
0.1.0 Mar 11, 2020

#26 in Date and time

Download history 101/week @ 2020-03-09 377/week @ 2020-03-16

201 downloads per month

MIT license

14KB
280 lines

MS converter library

Fast abstraction for converting human-like times into milliseconds. Like, are 1d to 86400000.

There are two ways to calculate milliseconds:

  • In the runtime crate::ms_converter::ms
  • In the compilation time crate::ms_converter::ms_expr

Getting Started

Usage

Add this to your Cargo.toml:

[dependencies]
ms-converter = "1.0"

Examples

Running ms converter in Runtime:

use crate::ms_converter::ms;

let value = ms("1d").unwrap();
assert_eq!(value, 86400000)

Convert ms in the compilation step:

use crate::ms_converter::ms_expr;

const VALUE: i64 = ms_expr!(i64, 1 d);
assert_eq!(VALUE, 86400000)

Convert ms into time.Duration

use crate::ms_converter::ms_into_time;

let value = ms_into_time("1d").unwrap();
assert_eq!(value.as_millis(), 86400000)

Supported time strings

  • Years: years, year, yrs, yr, y
  • Weeks: weeks, week, w
  • Days: days, day, d
  • Hours: hours, hour, hrs, hr, h
  • Minutes: minutes, minute, mins, min, m
  • Seconds: seconds, second, secs, sec, s
  • Milliseconds: milliseconds, millisecond, msecs, msec, ms and empty postfix

Performance

You can check the performance diff between ms_converter and ms libraries here.

Also, the macro has no time in the runtime! It will be converted into the const value.

Running the tests

Unit tests

cargo test

Coding style tests

Running code style tests

cargo fmt --all -- --check

Contributing

Just create pr or issue. You welcome.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

  • Mikhail Panfilov - Initial work - Mnwa

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

No runtime deps