WoW:API date: Difference between revisions
No edit summary |
(Linked to the API_time page for easy reference) |
||
| Line 3: | Line 3: | ||
date() is a reference to the os.date function. It is put in the global table as the os module is not available. | date() is a reference to the os.date function. It is put in the global table as the os module is not available. | ||
It returns a string or a table containing the user's machine's current date and time (or the time represented by <tt>time</tt>), formatted according to the given string <tt>format</tt>. If one wishes to supply your own format string, then it uses the same rules as [http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html strftime()]. The special string <tt>*t</tt> tells the <tt>date()</tt> function to return a table. | It returns a string or a table containing the user's machine's current date and time (or the [[API_time|time]] represented by <tt>time</tt>), formatted according to the given string <tt>format</tt>. If one wishes to supply your own format string, then it uses the same rules as [http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html strftime()]. The special string <tt>*t</tt> tells the <tt>date()</tt> function to return a table. | ||
This is a mirror of the LUA function [http://www.lua.org/manual/5. | This is a mirror of the LUA function [http://www.lua.org/manual/5.1/manual.html#pdf-os.date os.date()]. | ||
Note that the default format returned when calling the date() function with no parameters will be different depending on whether the game is running on a PC or a Macintosh computer. If you want your addon to be compatible with both systems, you should therefore not use date() without parameters, instead, use | Note that the default format returned when calling the date() function with no parameters will be different depending on whether the game is running on a PC or a Macintosh computer. If you want your addon to be compatible with both systems, you should therefore not use date() without parameters, instead, use | ||
Revision as of 06:07, 28 September 2007
date ([format [, time]])
date() is a reference to the os.date function. It is put in the global table as the os module is not available.
It returns a string or a table containing the user's machine's current date and time (or the time represented by time), formatted according to the given string format. If one wishes to supply your own format string, then it uses the same rules as strftime(). The special string *t tells the date() function to return a table.
This is a mirror of the LUA function os.date().
Note that the default format returned when calling the date() function with no parameters will be different depending on whether the game is running on a PC or a Macintosh computer. If you want your addon to be compatible with both systems, you should therefore not use date() without parameters, instead, use
date("%m/%d/%y %H:%M:%S")
to display the date in the default PC format
-or-
date("%a %b %d %H:%M:%S %Y")
to display the date in the default Macintosh format