Difference between revisions of "Os.time"

From GiderosMobile
 
(3 intermediate revisions by 2 users 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. This table must have fields year, month, and day, and may have fields hour, min, sec, and isdst (for a description of these fields, see the os.date function).  
+
Returns the current time when called without arguments, or a time representing the date and time specified by the given table.
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
(number) = os.time(table)
 
(number) = os.time(table)
</source>
+
</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 22: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

Os.date