Revision Difference
os.date#510447
<function name="date" parent="os" type="libraryfunc">⤶
<description>Returns the date/time as a formatted string or in a table.</description>⤶
<realm>Shared and Menu</realm>⤶
<args>⤶
<arg name="format" type="string">The format string.

If this is equal to '*t' or '!*t' then this function will return a <page>DateData</page>, otherwise it will return a string.

If this starts with an '!', the returned data will use the UTC timezone rather than the local timezone.

See http://www.mkssoftware.com/docs/man3/strftime.3.asp for available format flags.

<bug issue="329">**Not all flags are available on all operating systems** and the result of using an invalid flag is undefined. This currently crashes the game on Windows. Most or all flags are available on OS X and Linux but considerably fewer are available on Windows. See http://msdn.microsoft.com/en-us/library/fe06s4ak.aspx for a list of available flags on Windows. Note that the **#** flags also crashes the game on Windows.</bug></arg>⤶
<arg name="time" type="number">Time to use for the format.</arg>⤶
</args>⤶
<rets>⤶
<ret name="" type="string">Formatted date⤶
<note>This will be a <page>DateData</page> if the first argument equals to '*t' or '!*t'</note></ret>⤶
</rets>⤶
</function>⤶
⤶
<example>⤶
<description>⤶
This will use the os.time() function, and return it in a friendly way.⤶
os.time() is useful for storing as a date stamp but needs this to make it readable.⤶
</description>⤶
<code>⤶
local Timestamp = os.time()⤶
local TimeString = os.date( "%H:%M:%S - %d/%m/%Y" , Timestamp )⤶
print( "Timestamp:", Timestamp )⤶
print( "TimeString:", TimeString )⤶
</code>⤶
<outputfixedwidth>Fixed width</outputfixedwidth>⤶
<output>Timestamp:&#9;{{#time:U</output>⤶
⤶
</example>⤶
⤶
⤶
TimeString:	{{#time:H:i:s - d/m/Y}}⤶
}}