os.time
Lua function

os.time

Summary

Returns the current time or calculates the time in seconds from a table

Prototype

time = os.time (t)


Description

Returns the current time if no argument supplied. The time is in seconds from the start of the current epoch.

On Windows, the function returns the number of seconds elapsed since midnight (00:00:00), January 1, 1970, coordinated universal time, according to the system clock.

If an argument is supplied it must be a table with at least the entries:


  • year
  • month
  • day


The table can also have the entries:



  • hour
  • min
  • sec
  • isdst


This table can be produced by calling: os.date ("*t")


print (os.time { year = 2004, month = 8, 
                 day = 30, hour = 6, min = 32, sec = 1, dst = true }) --> 1093811521
print (os.date ("%x %X", 1093811521))  --> 30/08/04 06:32:01


See Also ...

Topics

DOC_lua_base Lua base functions
DOC_lua_bc Lua bc (big number) functions
DOC_lua_bit Lua bit manipulation functions
DOC_lua_coroutines Lua coroutine functions
DOC_lua_debug Lua debug functions
DOC_lua_io Lua io functions
DOC_lua_math Lua math functions
DOC_lua_os Lua os functions
DOC_lua_package Lua package functions
DOC_lua_rex Lua PCRE regular expression functions
DOC_lua Lua script extensions
DOC_lua_string Lua string functions
DOC_lua_tables Lua table functions
DOC_lua_utils Lua utilities
DOC_scripting Scripting

Lua functions

LUA_os.clock os.clock (Amount of CPU time used)
LUA_os.date os.date (Formats a date/time string)
LUA_os.difftime os.difftime (Calculates a time difference in seconds)
LUA_os.execute os.execute (Executes an operating system command)
LUA_os.exit os.exit (Attempts to terminate the process)
LUA_os.getenv os.getenv (Returns an operating system environment variable)
LUA_os.remove os.remove (Deletes a file)
LUA_os.rename os.rename (Renames a file)
LUA_os.setlocale os.setlocale (Sets the current locale to the supplied locale)
LUA_os.tmpname os.tmpname (Returns a name for a temporary file)

(Help topic: lua=os.time)

DOC_contents Documentation contents page