SetTime: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added sections, minor fixes, replaced example)
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 4: Line 4:


==Syntax==
==Syntax==
<section name="Server and Client" class="both" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setTime ( int hour, int minute )
bool setTime ( int hour, int minute )
Line 15: Line 14:
==Returns==
==Returns==
Returns ''true'' if the new time was successfully set, ''false'' otherwise.
Returns ''true'' if the new time was successfully set, ''false'' otherwise.
</section>


==Example==
==Example==
<section name="Example 1" class="server" show="true">
This serverside function sets the time and notifies players.
This serverside function sets the time and notifies players.
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function setTimeAndNotify( hour, minute )
function setTimeAndNotify( hour, minute )
Line 29: Line 27:
outputChatBox ( notifyMessage )
outputChatBox ( notifyMessage )
end
end
</syntaxhighlight>
</section>
<section name="Example 2" class="client" show="true">
This example freeze the time.
<syntaxhighlight lang="lua">
addEventHandler( 'onClientRender', root,
    function( )
        setTime( 1, 0 )
    end
)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
Line 34: Line 42:
==See Also==
==See Also==
{{World functions}}
{{World functions}}
[[ru:setTime]]

Latest revision as of 07:46, 4 November 2020

This function sets the current GTA time to the given time.

Syntax

bool setTime ( int hour, int minute )

Required Arguments

  • hour: The hour of the new time (range 0-23).
  • minute: The minute of the new time (range 0-59).

Returns

Returns true if the new time was successfully set, false otherwise.

Example

Click to collapse [-]
Example 1

This serverside function sets the time and notifies players.

function setTimeAndNotify( hour, minute )
	-- set the time first
	setTime ( hour, minute )
	-- format a notification message, adding leading zeros (e.g. 12:03 instead of 12:3)
	local notifyMessage = string.format("Time changed to %02d:%02d!", hour, minute)
	-- output the message
	outputChatBox ( notifyMessage )
end
Click to collapse [-]
Example 2

This example freeze the time.

addEventHandler( 'onClientRender', root,
    function( )
        setTime( 1, 0 )
    end
)

See Also

Shared