Difference between revisions of "Os.date"
From GiderosMobile
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | + | '''Available since:''' Gideros 2011.6<br/> | |
| − | ''' | + | '''Class:''' [[os]]<br/> |
| − | ''' | ||
| − | |||
| − | |||
| + | === Description === | ||
| + | Returns a string or a table containing date and time, formatted according to the given string format. | ||
| + | <source lang="lua"> | ||
| + | os.date(format,time) | ||
| + | </source> | ||
| − | If the time argument is present, this is the time to be formatted (see the os.time function for a description of this value). Otherwise, date formats the current time. | + | If the ''time'' argument is present, this is the time to be formatted (see the os.time function for a description of this value). Otherwise, '''date''' formats the current time. |
| − | |||
If format starts with '!', then the date is formatted in Coordinated Universal Time. After this optional character, if format is the string "*t", then date returns a table with the following fields: year (four digits), month (1--12), day (1--31), hour (0--23), min (0--59), sec (0--61), wday (weekday, Sunday is 1), yday (day of the year), and isdst (daylight saving flag, a boolean). | If format starts with '!', then the date is formatted in Coordinated Universal Time. After this optional character, if format is the string "*t", then date returns a table with the following fields: year (four digits), month (1--12), day (1--31), hour (0--23), min (0--59), sec (0--61), wday (weekday, Sunday is 1), yday (day of the year), and isdst (daylight saving flag, a boolean). | ||
| − | |||
If format is not "*t", then date returns the date as a string, formatted according to the same rules as the C function strftime. | If format is not "*t", then date returns the date as a string, formatted according to the same rules as the C function strftime. | ||
| + | When called without arguments, date returns a reasonable date and time representation that depends on the host system and on the current locale (that is, os.date() is equivalent to os.date("%c")). | ||
| − | + | === Parameters === | |
| − | + | '''format''': (string) format of the date<br/> | |
| − | + | '''time''': (number) time to format '''optional'''<br/> | |
| − | |||
| − | == | ||
| − | '''format''': (string) | ||
| − | '''time''': (number) | ||
{{Os}} | {{Os}} | ||
Revision as of 00:21, 29 October 2022
Available since: Gideros 2011.6
Class: os
Description
Returns a string or a table containing date and time, formatted according to the given string format.
os.date(format,time)
If the time argument is present, this is the time to be formatted (see the os.time function for a description of this value). Otherwise, date formats the current time.
If format starts with '!', then the date is formatted in Coordinated Universal Time. After this optional character, if format is the string "*t", then date returns a table with the following fields: year (four digits), month (1--12), day (1--31), hour (0--23), min (0--59), sec (0--61), wday (weekday, Sunday is 1), yday (day of the year), and isdst (daylight saving flag, a boolean).
If format is not "*t", then date returns the date as a string, formatted according to the same rules as the C function strftime.
When called without arguments, date returns a reasonable date and time representation that depends on the host system and on the current locale (that is, os.date() is equivalent to os.date("%c")).
Parameters
format: (string) format of the date
time: (number) time to format optional
