Difference between revisions of "Os.time"
From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>") |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 4: | Line 4: | ||
=== Description === | === Description === | ||
| − | Returns the current time when called without arguments, or a time representing the date and time specified by the given table | + | Returns the current time when called without arguments, or a time representing the date and time specified by the given table. |
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
(number) = os.time(table) | (number) = os.time(table) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | ''table'' fields: | ||
| + | *'''year''' | ||
| + | *'''month''' | ||
| + | *'''day''' | ||
| + | *'''''hour''''' ''optional'' | ||
| + | *'''''min''''' ''optional'' | ||
| + | *'''''sec''''' ''optional'' | ||
| + | *'''''isdst''''' ''optional'' | ||
'''The returned value is a number, whose meaning depends on your system. In POSIX, Windows, and some other systems, this number counts the number of seconds since some given start time (the "epoch": 1 January 1970, 00:00:00). In other systems, the meaning is not specified, and the number returned by time can be used only as an argument to date and ''difftime''''' | '''The returned value is a number, whose meaning depends on your system. In POSIX, Windows, and some other systems, this number counts the number of seconds since some given start time (the "epoch": 1 January 1970, 00:00:00). In other systems, the meaning is not specified, and the number returned by time can be used only as an argument to date and ''difftime''''' | ||
| Line 16: | Line 25: | ||
=== Return values === | === Return values === | ||
'''Returns''' (number) time in seconds<br/> | '''Returns''' (number) time in seconds<br/> | ||
| + | |||
| + | === Example === | ||
| + | <syntaxhighlight lang="lua"> | ||
| + | local myt = os.time({year=2003, month=7, day=14, hour=8}) | ||
| + | print(myt) | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | === See also === | ||
| + | [[Os.date]] | ||
{{Os}} | {{Os}} | ||
Latest revision as of 23:46, 14 October 2023
Available since: Gideros 2011.6
Class: os
Description
Returns the current time when called without arguments, or a time representing the date and time specified by the given table.
(number) = os.time(table)
table fields:
- year
- month
- day
- hour optional
- min optional
- sec optional
- isdst optional
The returned value is a number, whose meaning depends on your system. In POSIX, Windows, and some other systems, this number counts the number of seconds since some given start time (the "epoch": 1 January 1970, 00:00:00). In other systems, the meaning is not specified, and the number returned by time can be used only as an argument to date and difftime
Parameters
table: (table) table representing a date time optional
Return values
Returns (number) time in seconds
Example
local myt = os.time({year=2003, month=7, day=14, hour=8})
print(myt)
See also
