WoW:API date: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
No edit summary
 
m (Move page script moved page API date to API date without leaving a redirect)
 
(11 intermediate revisions by 11 users not shown)
Line 1: Line 1:
Seems to return the date as a string like:
{{wowlua}}
06/11/05 15:21:19
date() is a reference to the os.date function. It is put in the global table as the os module is not available.
date ([format [, time]])


The date appears to be in the american format even in europe, ie the "06" above
denotes the month, and the "11" is the day (Which would be written 11/6 most
places in Europe)


It appears the time is in the normal 24 hour clock though.
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.


The time returned is that of the users own machine and not the time of the server.
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


date("%m/%d/%y %H:%M:%S")
to display the date in the default PC format


Crash.
-or-
 
date("%a %b %d %H:%M:%S %Y")
to display the date in the default Macintosh format
 
== Also see ==
* {{api|GetGameTime}}()

Latest revision as of 04:45, 15 August 2023

WoW Lua

date() is a reference to the os.date function. It is put in the global table as the os module is not available.

date ([format [, time]])


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

Also see[edit]