date: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (removed colon from return value)
m (Some wiki formatting)
 
(56 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


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


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Return the actual mission date and time as an array {{Inline_code|[''year, month, day, hour, minute'']}}. Month is a full number between 1 and 12, day is between 1 and 31, hour is between 0 and 23 and minute is between 0 and 59. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| '''date''' |= Syntax
|game4= tkoh
|version4= 1.00


| [[Array]] - [year, month, day, hour, minute] |= Return value
|game5= arma3
____________________________________________________________________________________________
|version5= 0.50
|x1=<code>_now = [[date]];  // _now = [2014,10,30,2,30] ''(Oct. 30th, 2:30am)''
 
_hour = _now [[select]] 3;
|gr1= Environment
_min  = _now [[select]] 4;</code> |=Example 1
 
|x2=<code>[[if]] ([[date]] [[select]] 3 >= 19) [[then]] {  ''// 7pm''
|eff= local
  [[hintSilent]] "ah, Arma sunset";  ''//...cue bad guys''
 
};
|descr= Return the actual in-mission date and time.
</code> |=Example 2
 
|mp= Returns the current '''local''' (MP client) in-game date.
{{Feature|arma3|Clients' local date is [[Multiplayer Scripting#JIP Synchronisation|automatically and periodically synchronised]] with the server date.}}
 
|s1= [[date]]
 
|r1= [[Array]] - [[Date]] format


|mp= Returns the current <u>local</u> in game date.
|x1= <sqf>
// in {{arma3}}
date params ["_year", "_month", "_day", "_hours", "_minutes"];


| [[setDate]], [[dateToNumber]], [[numberToDate]], [[time]], [[missionStart]] |= See also
// pre {{arma3}}
private ["_now", "_year", "_month", "_day", "_hours", "_minutes"];
_now = date; // [2014,10,30,2,30] a.k.a Oct. 30th, 2:30am
_year = _now select 0;
_month = _now select 1;
_day = _now select 2;
_hours = _now select 3;
_minutes = _now select 4;
</sqf>


|x2= <sqf>
if (date select 3 >= 19) then // 7pm
{
hintSilent "ah, Arma sunset"; // ...cue bad guys
};
</sqf>
|seealso= [[setDate]] [[dateToNumber]] [[numberToDate]] [[time]] [[missionStart]] [[systemTime]] [[systemTimeUTC]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Lou Montana
<!-- Note Section BEGIN -->
|timestamp= 20180123233500
|text= a useful script to format the date:
<sqf>
_curDate = date;
private _ddMMyyyy = format ["%3/%2/%1",
_curDate select 0,
(if (_curDate select 1 < 10) then { "0" } else { "" }) + str (_curDate select 1),
(if (_curDate select 2 < 10) then { "0" } else { "" }) + str (_curDate select 2)
];
</sqf>


<!-- Note Section END -->
it can be shortened to: (no intermediary variable but more request to [[date]])
</dl>
<sqf>
private _ddMMyyyy = format ["%3/%2/%1",
date select 0,
(if (date select 1 < 10) then { "0" } else { "" }) + str (date select 1),
(if (date select 2 < 10) then { "0" } else { "" }) + str (date select 2)
];
</sqf>


<h3 style="display:none">Bottom Section</h3>
'''EDIT:''' or to
 
<sqf>
[[Category:Scripting Commands|DATE]]
private _ddMMyyyy = format ["%4%5/%2%3/%1",
[[Category:Scripting Commands ArmA|DATE]]
date select 0,
[[Category:Scripting Commands ArmA2|DATE]]
["", "0"] select (date select 1 < 10),
[[Category:Command_Group:_Mission_Information|DATE]]
date select 1,
[[Category:Command_Group:_Environment|{{uc:{{PAGENAME}}}}]]
["", "0"] select (date select 2 < 10),
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
date select 2
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
];
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
</sqf>
}}

Latest revision as of 20:08, 8 March 2024

Hover & click on the images for description

Description

Description:
Return the actual in-mission date and time.
Multiplayer:
Returns the current local (MP client) in-game date.
Arma 3
Clients' local date is automatically and periodically synchronised with the server date.
Groups:
Environment

Syntax

Syntax:
date
Return Value:
Array - Date format

Examples

Example 1:
// in Arma 3 date params ["_year", "_month", "_day", "_hours", "_minutes"]; // pre Arma 3 private ["_now", "_year", "_month", "_day", "_hours", "_minutes"]; _now = date; // [2014,10,30,2,30] a.k.a Oct. 30th, 2:30am _year = _now select 0; _month = _now select 1; _day = _now select 2; _hours = _now select 3; _minutes = _now select 4;
Example 2:
if (date select 3 >= 19) then // 7pm { hintSilent "ah, Arma sunset"; // ...cue bad guys };

Additional Information

See also:
setDate dateToNumber numberToDate time missionStart systemTime systemTimeUTC

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
Lou Montana - c
Posted on Jan 23, 2018 - 23:35 (UTC)
a useful script to format the date:
_curDate = date; private _ddMMyyyy = format ["%3/%2/%1", _curDate select 0, (if (_curDate select 1 < 10) then { "0" } else { "" }) + str (_curDate select 1), (if (_curDate select 2 < 10) then { "0" } else { "" }) + str (_curDate select 2) ];
it can be shortened to: (no intermediary variable but more request to date)
private _ddMMyyyy = format ["%3/%2/%1", date select 0, (if (date select 1 < 10) then { "0" } else { "" }) + str (date select 1), (if (date select 2 < 10) then { "0" } else { "" }) + str (date select 2) ];
EDIT: or to
private _ddMMyyyy = format ["%4%5/%2%3/%1", date select 0, ["", "0"] select (date select 1 < 10), date select 1, ["", "0"] select (date select 2 < 10), date select 2 ];