GetTimeProperty: Difference between revisions
DrinkyBird (talk | contribs) (Remove Devfeature) |
(Added an example) |
||
| Line 48: | Line 48: | ||
Note that due to ACS's limitations, the timestamp is suspectible to the [http://en.wikipedia.org/wiki/Year_2038_problem year 2038 problem]. | Note that due to ACS's limitations, the timestamp is suspectible to the [http://en.wikipedia.org/wiki/Year_2038_problem year 2038 problem]. | ||
== Examples == | |||
The following script checks if the game is being played on a Thursday the 20th. | |||
<syntaxhighlight lang="c" line="1"> | |||
script 1 OPEN | |||
{ | |||
if (GetTimeProperty(SystemTime(), TM_WEEKDAY) == 4 && GetTimeProperty(SystemTime(), TM_DAY) == 20) | |||
PrintBold(s:"Happy Thursday the 20th!"); | |||
} | |||
</syntaxhighlight> | |||
== See Also == | == See Also == | ||
*[[SystemTime]] | *[[SystemTime]] | ||
*[[Strftime]] | *[[Strftime]] | ||
Revision as of 11:57, 7 May 2021
|
This article documents a Zandronum-specific ACS feature which may not be supported by ZDoom and its other child ports. |
int GetTimeProperty (int timestamp, int which[, int utc])
Usage
Parameters
- timestamp: The timestamp to localize.
- which: Which attribute to return.
- utc: If true, the timestamp will be localized using the UTC timezone, local timezone otherwise
Time properties
| Property | Range | Description |
|---|---|---|
| TM_SECOND (0) | [0 - 61] | Seconds. Result is generally within [0, 59] but may very rarely exceed due to leap seconds. |
| TM_MINUTE (1) | [0 - 59] | Minutes |
| TM_HOUR (2) | [0, 23] | Hours |
| TM_DAY (3) | [0, 30] | Days |
| TM_MONTH (4) | [0, 11] | Month of the year |
| TM_YEAR (5) | [1901, 2038] | Year |
| TM_WEEKDAY (6) | [0, 6] | Weekday (Sunday is 0) |
Result value
Localizes the given timestamp and returns an attribute of it.
Note that due to ACS's limitations, the timestamp is suspectible to the year 2038 problem.
Examples
The following script checks if the game is being played on a Thursday the 20th.
script 1 OPEN
{
if (GetTimeProperty(SystemTime(), TM_WEEKDAY) == 4 && GetTimeProperty(SystemTime(), TM_DAY) == 20)
PrintBold(s:"Happy Thursday the 20th!");
}