setDate: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Some wiki formatting)
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma1 |Game name=
|game1= ofpe
|version1= 1.00


|1.00|Game version=
|game2= arma1
|version2= 1.00


|eff= local |Multiplayer Effects=
|game3= arma2
|version3= 1.00


|gr1= Mission Information |GROUP1=
|game4= arma2oa
|version4= 1.50


|gr2= Environment |GROUP2=
|game5= tkoh
____________________________________________________________________________________________
|version5= 1.00


| Sets mission date and time. This command is fully JIP compatible (as of Arma 3 v1.93.145588). Players joining after mission start will get the current server [[date]] including the year.
|game6= arma3
|version6= 0.50


{{Feature|arma3 | Clients' local date is [[Multiplayer Scripting#Join In Progress|automatically and periodically synchronised]] with the server date.}} |DESCRIPTION=
|eff= local


|mp= In order to change the date without waiting for automatic synchronisation, use remote execution:
|gr1= Mission Information
{{Inline code|[<nowiki/>[2001,6,22,12,0]] [[remoteExec]] ["setDate"];}} |MP BEHAVIOUR=
____________________________________________________________________________________________


| [[setDate]] date |SYNTAX=
|gr2= Environment


|p1= date: [[Date]] - format [year, month, day, hour, minute] |PARAMETER1=
|descr= Sets mission date and time. Players joining after mission start will get the current server [[date]] including the year.


| [[Nothing]] |RETURNVALUE=
|mp= {{Feature|arma3 |Clients' local date is [[Multiplayer Scripting#Join In Progress|automatically and periodically synchronised]] with the server date.<br>
____________________________________________________________________________________________
In order to change the date without waiting for automatic synchronisation, use remote execution: <sqf inline>[[2001,6,22,12,0]] remoteExec ["setDate"];</sqf>.}}
 
{{Feature|warning|While the game creates February 29th in a leap year, it removes December 31st. For example <sqf inline>setDate [1980,12,31,12,0]</sqf> will result in game jumping to [1981,1,1,12,0] as 1980 is a leap year.}}
|x1= <code>[[setDate]] [1986, 2, 25, 16, 0]; {{cc|4:00pm February 25, 1986}}</code> |EXAMPLE1=


|x2= Set the real date (MP only):
|s1= [[setDate]] date
<code>{{cc|postInit {{=}} 1;}}
[[if]] ([[isServer]]) [[then]]
{
[[waitUntil]] {[[time]] > 0};
[<nowiki/>[[missionStart]] [[select]] [0,5]] [[remoteExec]] ["setDate"];
};</code> |EXAMPLE2=
____________________________________________________________________________________________


| [[date]], [[skipTime]], [[numberToDate]], [[dateToNumber]] |SEEALSO=
|p1= date: [[Array]] format [[Date]]
}}


<h3 style="display:none">Notes</h3>
|r1= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">10:00, 7/12/2010 (BST)
|x1= <sqf>setDate [1986, 2, 25, 16, 0]; // 4:00pm February 25, 1986</sqf>
<dt class="note">[[User:Alpha|Alpha]]
<dd class="note">This command sets the date for the southern hemisphere only, i.e. when the map is in northern hemisphere a date [2010,12,7,17,0] is in day light and and date [2010,6,7,17,0] is in darkness.


<dd class="notedate">21:35, 31 October 2011 (EET)
|x2= <sqf>
<dt class="note">[[User:Osmo|Osmo]]
// postInit = 1;
<dd class="note">In multiplayer, the effect of this command is local, not global. The date from the server is synchronized with clients when they join the game (including start of the mission and joining in progress). E.g. if this command is executed on server in the init.sqf before the mission starts, every client will be synchronized with server as mission is started. However, if you run this command in the middle of the mission, effect is local.
// Set the real date (MP only):
if (isServer) then
{
waitUntil { time > 0 };
[missionStart select [0, 5]] remoteExec ["setDate"];
};
</sqf>


|seealso= [[date]] [[skipTime]] [[numberToDate]] [[dateToNumber]]
}}


<dd class="notedate">Posted on October 4, 2014 - 17:43 (UTC)</dd>
{{Note
<dt class="note">[[User:MulleDK13|MulleDK13]]</dt>
|user= Alpha
<dd class="note">
|timestamp= 20121207111000
Since an unknown version of {{arma3}}, this command now has global effect when executed on the server.
|text= This command sets the date for the southern hemisphere only, i.e. when the map is in northern hemisphere a date [2010,12,7,17,0] is in day light and and date [2010,6,7,17,0] is in darkness.
</dd>
}}


<dd class="notedate">Posted on February 5, 2015 - 06:38 (UTC)</dd>
{{Note
<dt class="note">[[User:Ozdeadmeat|Ozdeadmeat]]</dt>
|user= Osmo
<dd class="note">
|timestamp= 20111031210700
Arma 3 1.38.128937- Leapyear BUG - setdate [2016,12,31,23,59] yields an ingame date of the 1st of January 2017. If left to tick over from the 30th of December it ticks to 1st January skipping the 31st of December entirely.
|text= In multiplayer, the effect of this command is local, not global. The date from the server is synchronized with clients when they join the game (including start of the mission and joining in progress). E.g. if this command is executed on server in the init.sqf before the mission starts, every client will be synchronized with server as mission is started. However, if you run this command in the middle of the mission, effect is local.
</dd>
}}


<dd class="notedate">Posted on April 23, 2017 - 02:58 (UTC)</dd>
{{Note
<dt class="note">[[User:OOKexOo|OOKexOo]]</dt>
|user= MulleDK13
<dd class="note">
|timestamp= 20141004174300
Regarding execution in the middle of a session, the post of [[User:MulleDK13|MulleDK13]] is not entirely true. If you don't change the year, you are perfectly fine when executing the command on the server only. However, the server does not sync the year. Hence, if you do change the year, you have to execute the command on the server, clients and JIP to account for the missing sync. e.g.<br>
|text= Since an unknown version of {{arma3}}, this command now has global effect when executed on the server.
<code>[[], {[[setDate]] [1986, 2, 25, 16, 0]}] [[remoteExec]] ["[[call]]",0,"JIP_id_setDate"];</code>
}}
</dd>


<!-- Note Section END -->
{{Note
</dl>
|user= OOKexOo
 
|timestamp= 20170423025800
<h3 style="display:none">Bottom Section</h3>
|text= Regarding execution in the middle of a session, the post of [[User:MulleDK13|MulleDK13]] is not entirely true. If you don't change the year, you are perfectly fine when executing the command on the server only. However, the server does not sync the year. Hence, if you do change the year, you have to execute the command on the server, clients and JIP to account for the missing sync. e.g.
[[Category:Scripting Commands OFP Elite |{{uc:{{PAGENAME}}}}]]
<sqf>[[], { setDate [1986, 2, 25, 16, 0] }] remoteExec ["call", 0, "JIP_id_setDate"];</sqf>
{{GameCategory|arma1|Scripting Commands}}
}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 17:26, 25 July 2022

Hover & click on the images for description

Description

Description:
Sets mission date and time. Players joining after mission start will get the current server date including the year.
Multiplayer:
Arma 3
Clients' local date is automatically and periodically synchronised with the server date.
In order to change the date without waiting for automatic synchronisation, use remote execution: [[2001,6,22,12,0]] remoteExec ["setDate"];.
While the game creates February 29th in a leap year, it removes December 31st. For example setDate [1980,12,31,12,0] will result in game jumping to [1981,1,1,12,0] as 1980 is a leap year.
Groups:
Mission InformationEnvironment

Syntax

Syntax:
setDate date
Parameters:
date: Array format Date
Return Value:
Nothing

Examples

Example 1:
setDate [1986, 2, 25, 16, 0]; // 4:00pm February 25, 1986
Example 2:
// postInit = 1; // Set the real date (MP only): if (isServer) then { waitUntil { time > 0 }; [missionStart select [0, 5]] remoteExec ["setDate"]; };

Additional Information

See also:
date skipTime numberToDate dateToNumber

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Alpha - c
Posted on Dec 07, 2012 - 11:10 (UTC)
This command sets the date for the southern hemisphere only, i.e. when the map is in northern hemisphere a date [2010,12,7,17,0] is in day light and and date [2010,6,7,17,0] is in darkness.
Osmo - c
Posted on Oct 31, 2011 - 21:07 (UTC)
In multiplayer, the effect of this command is local, not global. The date from the server is synchronized with clients when they join the game (including start of the mission and joining in progress). E.g. if this command is executed on server in the init.sqf before the mission starts, every client will be synchronized with server as mission is started. However, if you run this command in the middle of the mission, effect is local.
MulleDK13 - c
Posted on Oct 04, 2014 - 17:43 (UTC)
Since an unknown version of Arma 3, this command now has global effect when executed on the server.
OOKexOo - c
Posted on Apr 23, 2017 - 02:58 (UTC)
Regarding execution in the middle of a session, the post of MulleDK13 is not entirely true. If you don't change the year, you are perfectly fine when executing the command on the server only. However, the server does not sync the year. Hence, if you do change the year, you have to execute the command on the server, clients and JIP to account for the missing sync. e.g.
[[], { setDate [1986, 2, 25, 16, 0] }] remoteExec ["call", 0, "JIP_id_setDate"];