Fast abstraction for converting human-like times into milliseconds.

Mikhail Panfilov

Last update: Nov 7, 2022

Related tags

Date and time ms

Overview

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

You might also like...

Qovery Engine is an open-source abstraction layer library that turns easy apps deployment on AWS, GCP, Azure, and other Cloud providers in just a few minutes.

1.9k Jan 4, 2023

Rust Hardware Abstraction Layer (HAL) crate for the Vorago VA108xx family of MCUs

HAL for the Vorago VA108xx MCU family This repository contains the Hardware Abstraction Layer (HAL), which is an additional hardware abstraction on to

0 Dec 22, 2021

Hardware Abstraction Layer for ATmega32U4

Deprecation Note: This crate will soon be deprecated in favor of avr-hal. avr-hal is a new approach to writing the HAL crate, that was designed with s

3 May 16, 2021

Hardware Abstraction Layer for AVR microcontrollers and common boards

avr-hal Hardware Abstraction Layer for AVR microcontrollers and common boards (for example Arduino). Based on the avr-device crate. This is a new vers

776 Jan 1, 2023

An asynchronous Hardware Abstraction Layer (HAL) for embedded systems

embedded-hal-async An asynchronous Hardware Abstraction Layer (HAL) for embedded systems. This crate contains asynchronous versions of the embedded-ha

3 Jan 22, 2022

A rustic tcp + serialization abstraction.

Wire An abstraction over TCP and Serialization "put a struct in one side and it comes out the other end" Wire is a library that makes writing applicat

33 May 12, 2021

Garden monitoring system using m328p Arduino Uno boards. 100% Rust [no_std] using the avr hardware abstraction layer (avr-hal)

uno-revive-rs References Arduino Garden Controller Roadmap uno-revive-rs: roadmap Components & Controllers 1-2 Uno R3 m328p Soil moisture sensor: m328

1 May 4, 2022

An abstraction build on top of discord-rich-presence that makes possible to use it in a more declarative way

Declarative Discord Rich Presence This library is an abstraction build on top of discord-rich-presence crate that allows you to use it in a more decla

2 Sep 7, 2022

This is the core library with the full abstraction and implementation of the Minecraft protocol and logic. (Currently WIP)

MineRust (WIP) This is the core library with the full abstraction and implementation of the Minecraft protocol and logic. This project is currently WI

2 Nov 20, 2022

A Boring(SSL)-compatible API abstraction for Rust cryptographic implementations.

A Boring(SSL)-compatible API abstraction for Rust cryptographic implementations. What is Superboring? Superboring hides the complexity, diversity and

7 Dec 29, 2023

Library + CLI-Tool to measure the TTFB (time to first byte) of HTTP requests. Additionally, this crate measures the times of DNS lookup, TCP connect and TLS handshake.

TTFB: CLI + Lib to Measure the TTFB of HTTP/1.1 Requests Similar to the network tab in Google Chrome or Mozilla Firefox, this crate helps you find the

24 Dec 1, 2022

Comments

Is the reverse possible?

Hey!

Thank you for this library. It's quite useful.

I was wondering if the reverse of what this library does is possible? That is, given a u64 representing milliseconds, can we get the human-readable version of it?

opened by rakshith-ravi 15
Perhaps return std::time::Duration rather than i64?

Hi, thanks for your work on this library.

The standard library includes std::time::Duration as a type safe way of passing around time durations. Have you considered returning that type rather than an i64?

opened by JoshMcguigan 2

Releases(1.4.0)

1.4.0(May 2, 2020)
Features

get_max_possible_duration function which converts milliseconds into human-like time string without postfix.

Source code(tar.gz)
Source code(zip)
1.3.1(May 1, 2020)
Features

get_duration_by_postfix function, which converts milliseconds into a human-like time string

get_max_possible_duration function, which converts milliseconds into a human-like time string without postfix

Source code(tar.gz)
Source code(zip)

1.2.1(Apr 28, 2020)

Features

Added + support

let value = ms("+100").unwrap();
assert_eq!(value, 100)

Now ms supported only one whitespace between number and postfix

let value = ms("100 ms").unwrap(); // valid
assert_eq!(value, 100)

let value = ms("100  ms").unwrap(); // invalid
assert_eq!(value, 100)

Optimizes

Now it works on 2x faster! (from 16ns to 8ns)

Source code(tar.gz)
Source code(zip)

1.1.1(Mar 28, 2020)
Improvements

Now ms, ms_into_time and ms_expr! have normal descriptions on index page docs

Source code(tar.gz)
Source code(zip)
1.1.0(Mar 28, 2020)
Features

Now ms_converter used no_std directive, which makes it possible to use it on embedded devices.

Improvements

Converted Cow pointer into an str slice, which can save 1-2 ns per call.

Updated docs on doc.rs

Source code(tar.gz)
Source code(zip)
1.0.0(Mar 25, 2020)
Features

Now ms and ms_into_time functions support String on input without breaking changes.

Improvements

Increased performance. ms function sped up ~ 60%! From 27 ns per iter to 16 ns per iter on the benches.

Added many new tests.

Source code(tar.gz)
Source code(zip)
0.7.4(Mar 24, 2020)

Now a doc has a examples of supported time strings.
Source code(tar.gz)
Source code(zip)
0.7.3(Mar 23, 2020)

Now it more readable
Source code(tar.gz)
Source code(zip)
0.7.2(Mar 23, 2020)

Add small improvements, now ms search value with bytes
Source code(tar.gz)
Source code(zip)
0.7.1(Mar 18, 2020)
Changes

Added docs for constants and Error struct

Source code(tar.gz)
Source code(zip)

0.7.0(Mar 18, 2020)

Features

Now you can convert str slice into time.Duration!

Example

use crate::ms_converter::ms_into_time;

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

Source code(tar.gz)
Source code(zip)

0.6.0(Mar 17, 2020)
Features

crate::ms_converter::ms_expr macro, now you can convert time into constants and calculate values in a compilation.

Example:

use crate::ms_converter::ms_expr; const VALUE: i64 = ms_expr!(i64, 1 d); assert_eq!(VALUE, 86400000)
Source code(tar.gz)
Source code(zip)
0.5.1(Mar 16, 2020)

Now ms function will be inlined, which will save 3-4ns on benches
Source code(tar.gz)
Source code(zip)
0.5.0(Mar 13, 2020)
Breaking changes

Now ms library returned i64 type

Source code(tar.gz)
Source code(zip)
0.4.2(Mar 13, 2020)

Source code(tar.gz)
Source code(zip)
0.4.1(Mar 12, 2020)

Source code(tar.gz)
Source code(zip)
0.4.0(Mar 12, 2020)

Source code(tar.gz)
Source code(zip)
0.3.0(Mar 12, 2020)

Increased perf from 436 ns/iter to 4 ns/iter
Source code(tar.gz)
Source code(zip)
0.2.0(Mar 12, 2020)

#Breaking changes Now you must pass &str to ms function
Source code(tar.gz)
Source code(zip)
0.1.0(Mar 12, 2020)

Source code(tar.gz)
Source code(zip)

Fast abstraction for converting human-like times into milliseconds.

Related tags

Overview

MS converter library

Getting Started

Usage

Examples

Running ms converter in Runtime:

Convert ms in the compilation step:

Convert ms into time.Duration

Convert milliseconds into human-like time string

Convert milliseconds into human-like time string without postfix

Convert milliseconds into long human-like time string without postfix

Supported time strings

Performance

Running the tests

Unit tests

Coding style tests

Contributing

Versioning

Authors

License

You might also like...

Qovery Engine is an open-source abstraction layer library that turns easy apps deployment on AWS, GCP, Azure, and other Cloud providers in just a few minutes.

Rust Hardware Abstraction Layer (HAL) crate for the Vorago VA108xx family of MCUs

Hardware Abstraction Layer for ATmega32U4

Hardware Abstraction Layer for AVR microcontrollers and common boards

An asynchronous Hardware Abstraction Layer (HAL) for embedded systems

A rustic tcp + serialization abstraction.

Garden monitoring system using m328p Arduino Uno boards. 100% Rust [no_std] using the avr hardware abstraction layer (avr-hal)

An abstraction build on top of discord-rich-presence that makes possible to use it in a more declarative way

This is the core library with the full abstraction and implementation of the Minecraft protocol and logic. (Currently WIP)

A Boring(SSL)-compatible API abstraction for Rust cryptographic implementations.

Library + CLI-Tool to measure the TTFB (time to first byte) of HTTP requests. Additionally, this crate measures the times of DNS lookup, TCP connect and TLS handshake.

atttribute macro for running a flaky test multiple times

Make any NixOS system netbootable with 10s cycle times.

Convert timestamps to local times

clockchain is a system for benchmarking smart contract execution times across blockchains.

clockchain is a system for benchmarking smart contract execution times across blockchains.

Fake ping times.

Showcase for pathological compile times when using knuffel / chumsky / VERY LARGE types

Utility to inherit dependencies from workspace file if it occurs 'n' or more times throughout the project.

Comments

Is the reverse possible?

Perhaps return std::time::Duration rather than i64?

Releases(1.4.0)

1.4.0(May 2, 2020)

Features

1.3.1(May 1, 2020)

Features

1.2.1(Apr 28, 2020)

Features

Optimizes

1.1.1(Mar 28, 2020)

Improvements

1.1.0(Mar 28, 2020)

Features

Improvements

1.0.0(Mar 25, 2020)

Features

Improvements

0.7.4(Mar 24, 2020)

0.7.3(Mar 23, 2020)

0.7.2(Mar 23, 2020)

0.7.1(Mar 18, 2020)

Changes

0.7.0(Mar 18, 2020)

Features

0.6.0(Mar 17, 2020)

Features

0.5.1(Mar 16, 2020)

0.5.0(Mar 13, 2020)

Breaking changes

0.4.2(Mar 13, 2020)

0.4.1(Mar 12, 2020)

0.4.0(Mar 12, 2020)

0.3.0(Mar 12, 2020)

0.2.0(Mar 12, 2020)

0.1.0(Mar 12, 2020)

Owner

Convert ms into `time.Duration`