SystemTime

From ZDoom Wiki
Jump to navigation Jump to search
Note: This feature is for ZScript only.

Methods

  • 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.

See Also