GetRealTime: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 56: Line 56:
===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}  
{{OptionalArg}}  
{{New feature|3|1.0|
{{New feature/item|3|1.0||
*'''seconds:''' A count in seconds from the year 1970.  Useful for storing points in time, or for retrieving time information for [[getBanTime]].
*'''seconds:''' A count in seconds from the year 1970.  Useful for storing points in time, or for retrieving time information for [[getBanTime]].
}}
}}

Revision as of 08:08, 21 November 2011

This function gets the real server time and returns it in a table. If you want to get the in-game time (shown on GTA's clock) use getTime.

Syntax

table getRealTime( [int seconds = current] )

Returns

Returns a table of substrings with different time format, false otherwise.

Member Meaning Range
second seconds after the minute 0-61*
minute minutes after the hour 0-59
hour hours since midnight 0-23
monthday day of the month 1-31
month months since January 0-11
year years since 1900
weekday days since Sunday 0-6
yearday days since January 1 0-365
isdst Daylight Saving Time flag
timestamp seconds since 1970 (MTA 1.1 +)
  • tm_sec is generally 0-59. Extra range to accommodate for leap seconds in certain systems.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • seconds: A count in seconds from the year 1970. Useful for storing points in time, or for retrieving time information for getBanTime.

Example

This example outputs local time (server or client, where ever it was triggered) as hours and minutes

function showtime ()
	local time = getRealTime()
	local hours = time.hour
	local minutes = time.minute
	outputChatBox ( "Local Time: "..hours..":"..minutes )
end

See Also