Os.time: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
 
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.
<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 19: Line 28:
=== Example ===
=== Example ===
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local mybday = os.time({year=2003, month=7, day=14, hour=8})
local myt = os.time({year=2003, month=7, day=14, hour=8})
print(mybday)
print(myt)
</syntaxhighlight>
</syntaxhighlight>
=== See also ===
[[Os.date]]


{{Os}}
{{Os}}

Latest revision as of 21: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