wts

Warp the Timestamps or something.

Usage

This library is for use with the suggested Erlang VM args for time warp mode and time correction:

$ cat config/vm.args
...
+c true
+C multi_time_warp

These settings require that you have only Time Warp Safe Code.

Time correction is enabled by Erlang by default if it supported by your system, while the default time warp mode is no_time_warp because this is how the runtime behaved before the addition of time warp modes.

Example usage to find the time elapsed while performing some function and converting to a timestamp that is in microseconds since the epoch, so has meaning outside of the Erlang runtime. The wts timestamp uses the Erlang runtime's native time unit for the best accuracy and precision and only converts to microseconds when returning the result of duration/2 and to_absolute/1.

> StartTime = wts:timestamp().
> %% do something
> EndTime = wts:timestamp().

%% get the duration in microseconds
> wts:duration(StartTime, EndTime).

%% convert to microseconds since the epoch
> wts:to_absolute(StartTime).

Additionally there is support for converting to an rfc3339 format string:

> wts:rfc3339(wts:timestamp()).
<<"2017-09-15T02:48:11.118825Z">>

Credits

Created thanks to Elixir's Tapper timestamp module.