Strftime: Difference between revisions
DrinkyBird (talk | contribs) No edit summary |
DrinkyBird (talk | contribs) No edit summary Tag: Source edit |
||
| Line 1: | Line 1: | ||
{{Template:ACSWarning}} | {{Template:ACSWarning}} | ||
str '''Strftime'''(int timestamp, str format['', int utc'']) | str '''Strftime''' (int timestamp, str format['', int utc'']) | ||
== Usage == | == Usage == | ||
=== Parameters === | === Parameters === | ||
| Line 10: | Line 10: | ||
=== Return value === | === Return value === | ||
A human-readable string from the given timestamp, formatted using the format parameter. | A human-readable string from the given timestamp, formatted using the ''format'' parameter. | ||
Note that due to ACS's limitations, timestamps are suspectible to the [ | Note that due to ACS's limitations, timestamps are suspectible to the [[wikipedia:Year 2038 problem|year 2038 problem]]. | ||
== | == Examples == | ||
This prints something like <code>{{CURRENTMONTHNAME}} {{CURRENTDAY}} {{CURRENTYEAR}}</code> to the screen. | This prints something like <code>{{CURRENTMONTHNAME}} {{CURRENTDAY}} {{CURRENTYEAR}}</code> to the screen. | ||
| Line 24: | Line 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== See | == See also == | ||
*[[SystemTime]] | * [[SystemTime]] | ||
*[[GetTimeProperty]] | * [[GetTimeProperty]] | ||
[[Category: ACS functions]] | |||
Latest revision as of 01:08, 3 July 2022
|
This article documents a Zandronum-specific ACS feature which may not be supported by ZDoom and its other child ports. |
str Strftime (int timestamp, str format[, int utc])
Usage
Parameters
- timestamp: the timestamp to format (use SystemTime to get the current time])
- format: a string describing how the string is formatted. It may contain any supported conversion specifiers, which are replaced as appropriate.
- utc: If true, then the timestamp will be localized using the UTC timezone, local timezone otherwise.
Return value
A human-readable string from the given timestamp, formatted using the format parameter.
Note that due to ACS's limitations, timestamps are suspectible to the year 2038 problem.
Examples
This prints something like November 22 2024 to the screen.
Script 1 (void)
{
Print (s: Strftime (SystemTime(), "%B %d %Y", true));
}