Structs:SystemTime

Usage

SystemTime is a ZScript struct that contains methods to obtain the player's system time.

Methods

Static

• static ui int Now()

Returns the system time, as far as GZDoom is concerned, as a 32-bit signed integer timestamp. The getdate/setdate CCMDs can be used to get/set what time GZDoom thinks it is, respectively.

• static String Format (String timeForm, int timeVal)

Allows to format a string using a subset of C strftime format.

Format	Description	Example
%a	Abbreviated weekday name	Thu
%A	Full weekday name	Thursday
%b,%h	Abbreviated month name	Aug
%B	Full month name	August
%c	Date and time representation	Thu Aug 23 14:55:02 2001
%C	Year divided by 100 and truncated to integer (00-99)	20
%d	Day of the month, zero-padded (01-31)	23
%D	Short MM/DD/YY date, equivalent to %m/%d/%y	08/23/01
%e	Day of the month, space-padded ( 1-31)	23
%F	Short YYYY-MM-DD date, equivalent to %Y-%m-%d	2001-08-23
%g	Week-based year, last two digits (00-99)	01
%G	Week-based year	2001
%H	Hour in 24h format (00-23)	14
%I	Hour in 12h format (01-12)	02
%j	Day of the year (001-366)	235
%m	Month as a decimal number (01-12)	08
%M	Minute (00-59)	55
%n	New-line character ('\n')
%p	AM or PM designation	PM
%r	12-hour clock time	02:55:02 pm
%R	24-hour HH:MM time, equivalent to %H:%M	14:55
%S	Second (00-61)	02
%t	Horizontal-tab character ('\t')
%T	ISO 8601 time format (HH:MM:SS), equivalent to %H:%M:%S	14:55:02
%u	ISO 8601 weekday as number with Monday as 1 (1-7)	4
%U	Week number with the first Sunday as the first day of week one (00-53)	33
%V	ISO 8601 week number (01-53)	34
%w	Weekday as a decimal number with Sunday as 0 (0-6)	4
%W	Week number with the first Monday as the first day of week one (00-53)	34
%x	Date representation	08/23/01
%X	Time representation	14:55:02
%y	Year, last two digits (00-99)	01
%Y	Year	2001
%z	ISO 8601 offset from UTC in timezone (1 minute=1, 1 hour=100) If timezone cannot be determined, no characters	+100
%Z	Timezone name or abbreviation If timezone cannot be determined, no characters	CDT
%%	A % sign	%

• The specifiers in yellow are locale-dependent.

Note that due to the fact that ZScript does not have 64-bit integers, the timestamp is susceptible to the year 2038 problem.