ms

Fast abstraction for converting human-like times into milliseconds.

Project maintained by Mnwa Hosted on GitHub Pages — Theme by mattgraham

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.4"

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)

Convert milliseconds into human-like time string

use crate::ms_converter::{get_duration_by_postfix, DAY};

let value = get_duration_by_postfix(DAY as i64, " day").unwrap();
assert_eq!(value, "1 day")

Convert milliseconds into human-like time string without postfix

use crate::ms_converter::{get_max_possible_duration, DAY};

let value = get_max_possible_duration(DAY as i64).unwrap();
assert_eq!(value, "1d")

Convert milliseconds into long human-like time string without postfix

use crate::ms_converter::{get_max_possible_duration_long, WEEK};

let value = get_max_possible_duration_long(2 * WEEK as i64).unwrap();
assert_eq!(value, "14 days") // Max possible period is a day

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

ms