.config/awesome/modules/luatz/doc/gettime.md

   1 ## `luatz.gettime` <!-- --> {#gettime}
   2
   3 A module to get the current time.
   4
   5 Uses the most precise method available (in order:)
   6
   7   - Use [ljsyscall](http://www.myriabit.com/ljsyscall/) to access `clock_gettime(2)` called with `CLOCK_REALTIME`
   8   - [lunix](http://25thandclement.com/~william/projects/lunix.html)'s `unix.clock_gettime()` (Only on non-Apple systems)
   9   - Use [ljsyscall](http://www.myriabit.com/ljsyscall/) to access `gettimeofday(2)`
  10   - [lunix](http://25thandclement.com/~william/projects/lunix.html)'s `unix.gettimeofday()`
  11   - [luasocket](http://w3.impa.br/~diego/software/luasocket/)'s `socket.gettime`
  12   - [Openresty](http://openresty.org/)'s [`ngx.now`](http://wiki.nginx.org/HttpLuaModule#ngx.now)
  13   - [`os.time`](http://www.lua.org/manual/5.3/manual.html#pdf-os.time)
  14
  15 ### `source` <!-- --> {#gettime.source}
  16
  17 The library/function currently in use by [`gettime()`](#gettime.gettime).
  18
  19
  20 ### `resolution` <!-- --> {#gettime.resolution}
  21
  22 The smallest time resolution (in seconds) available from [`gettime()`](#gettime.gettime).
  23
  24
  25 ### `gettime()` <!-- --> {#gettime.gettime}
  26
  27 Returns the number of seconds since unix epoch (1970-01-01T00:00:00Z) as a lua number