X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/33e6d576521eb23df0e11944616af37fb261f121..7cefb5bfb88f1bfc2d4075fa0e29b10d403ac7d7:/doc/gettime.md diff --git a/doc/gettime.md b/doc/gettime.md index 76eddfb..3550577 100644 --- a/doc/gettime.md +++ b/doc/gettime.md @@ -1,11 +1,27 @@ -# `luatz.gettime` +## `luatz.gettime` {#gettime} A module to get the current time. +Uses the most precise method available (in order:) -## `gettime` + - Use [ljsyscall](http://www.myriabit.com/ljsyscall/) to access `clock_gettime(2)` called with `CLOCK_REALTIME` + - [lunix](http://25thandclement.com/~william/projects/lunix.html)'s `unix.clock_gettime()` (Only on non-Apple systems) + - Use [ljsyscall](http://www.myriabit.com/ljsyscall/) to access `gettimeofday(2)` + - [lunix](http://25thandclement.com/~william/projects/lunix.html)'s `unix.gettimeofday()` + - [luasocket](http://w3.impa.br/~diego/software/luasocket/)'s `socket.gettime` + - [Openresty](http://openresty.org/)'s [`ngx.now`](http://wiki.nginx.org/HttpLuaModule#ngx.now) + - [`os.time`](http://www.lua.org/manual/5.3/manual.html#pdf-os.time) -Uses the most accurate method available (in order:) +### `source` {#gettime.source} - - Uses luasocket's `socket.gettime` if available - - `os.time` +The library/function currently in use by [`gettime()`](#gettime.gettime). + + +### `resolution` {#gettime.resolution} + +The smallest time resolution (in seconds) available from [`gettime()`](#gettime.gettime). + + +### `gettime()` {#gettime.gettime} + +Returns the number of seconds since unix epoch (1970-01-01T00:00:00Z) as a lua number