os.date
From GMod Wiki
| Function | |
| Syntax |
os.date( [ String format, Number time ] ) Where is this used? |
| Description: | |
| Returns a string or a table containing date and time, formatted according to the given string format. | |
| Returns: | String or Table |
| Part of Library: | os |
| Realm: |
 |
| BBCode Link: | [b][url=http://wiki.garrysmod.com/?title=Os.date]Os.date [img]http://wiki.garrysmod.com/favicon.ico[/img][/url][/b] |
Examples
| Description | Prints the current date to the console. |
|---|---|
| Used on | |
| Code | MsgN( "The current date is: " .. tostring( os.date() ) ) |
| Output | The current date is: [date here] |
Full List of Format Flags
- Quoted from http://www.mkssoftware.com/docs/man3/strftime.3.asp, hope this is okay.
%a is replaced by the locale's abbreviated weekday name. %A is replaced by the locale's full weekday name. %b is replaced by the locale's abbreviated month name. %B is replaced by the locale's full month name. %c is replaced by the locale's appropriate date and time representation. %C is replaced by the century number (the year divided by 100 and truncated to an integer) as a decimal number [00,99]. %d is replaced by the day of month as a decimal number [01,31]. %D is the same as %m/%d/%y. %h is the same as %b. %H is replaced by the hour in 24-hour format [00,23]. %I is replaced by the hour in 12-hour format [01,12]. %j is replaced by the day of year as a decimal number [001,366]. %k is replaced by the hour in 24-hour format as a decimal number [0,23]]; a single digit is preceded by a space. %l is replaced by the hour in 12-hour format as a decimal number [1,12]; a single digit is preceded by a space. %m is replaced by the month as a decimal number [01,12]. %M is replaced by the minute as a decimal number [00,59]. %n is replaced by a newline character. %p is replaced by the locale's equivalent of either A.M./P.M. indicator for 12-hour clock. %R is replaced by the time in 24 hour notation (%H:%M). %s is replaced by the time in seconds since the epoch as a decimal number. %S is replaced by the second as a decimal number [00,59]. %t is replaced by a tab character. %T is replaced by the time (%H:%M:%S). %u is replaced by the weekday as a decimal number [1,7], with 1 representing Monday. %U is replaced by the week of the year as a decimal number, with Sunday as first day of week [00,53]. %V is replaced by the week of the year as a decimal number, with Monday as the first day of the week (01 - 53). If the week containing January 1st has four or more days in the new year, then it is considered week 1. Otherwise, it is week 53 of the previous year, and the next week is week 1. %w is replaced by the weekday as a decimal number [0,6]; Sunday is 0. %W is replaced by the week of the year as a decimal number, with Monday as first day of week [00,53]. All days in a new year preceding the first Monday are considered to be in week 0. %x is replaced by the locale's appropriate date representation. %X is replaced by the locale's appropriate time representation. %y is replaced by the year without century, as a decimal number [00,99]. %Y is replaced by the year with century, as a decimal number. %z, %Z is replaced by the time zone name or abbreviation, or by no characters if no time zone information exists. %% is replaced by %.
Some conversion specifiers can be modified by the E or O modifier characters to indicate that an alternative format of specification should be used rather that the one normally used by the unmodified conversion specifier. If the alternative format or specification does not exist for he current locale, the behavior is as if the unmodified conversion specification were used. It is an error to specify the E or O modifier with any conversion specification not listed here.
%Ec is replaced by the locale's alternative appropriate date and time representation. %EC is replaced by the name of the base year (period) in the locale's alternative representation. %Ex is replaced by the locale's alternative date representation. %EX is replaced by the locale's alternative time representation. %Ey is replaced by the offset from %EC (year only) in the locale's alternative representation. %EY is replaced by the full alternative year representation. %Od is replaced by the day of the month, using the locale's alternative numeric symbols, filled as needed with leading zeros if there is any alternative symbol for zero, otherwise with leading spaces. %Oe is replaced by the day of the month, using the locale's alternative numerical symbols, filled as needed with leading spaces. %OH is replaced by the hour in 24-hour format using the locale's alternative numeric symbols. %OI is replaced by the hour in 12-hour format using the locale's alternative numeric symbols. %Om is replaced by the month using the locale's alternative numeric symbols %OM is replaced by the minutes using the locale's alternative numeric symbols. %OS is replaced by the seconds using the locale's alternative numeric symbols. %Ou is replaced by the weekday as a number using the locale's alternative representation, with 1 representing Monday. %OU is replaced by the week number of the year (Sunday as the first day of the week, rules corresponding to %U) using the locale's alternative numeric symbols. %OV is replaced by the week number of the year (Monday as the first day of the week, rules corresponding to %V) using the locale's alternative numeric symbols. %Ow is replaced by the number of the weekday using the locale's alternative numeric symbols, with 0 representing Sunday. %OW is replaced by the week number of the year (Monday as the first day of the week) using the locale's alternative numeric symbols. %Oy is replaced by the year (offset from %C) using the locale's alternative numeric symbols.
Additional Notes
- If the time argument is present, this is the time to be formatted (see the os.time function for a description of this value). Otherwise, date formats the current time.
- If format starts with '!', then the date is formatted in Coordinated Universal Time. After this optional character, if format is the string "*t", then date returns a table with the following fields: year (four digits), month (1--12), day (1--31), hour (0--23), min (0--59), sec (0--61), wday (weekday, Sunday is 1), yday (day of the year), and isdst (daylight saving flag, a Boolean ).
- If format is not "*t", then date returns the date as a string, formatted according to the same rules as the C function strftime.
- When called without arguments, date returns a reasonable date and time representation that depends on the host system and on the current locale (that is, os.date() is equivalent to os.date("%c")).
- One or more of the following arguments crashes the game: %e %T %R %s %k
- Doing os.date('!t').var does not seem to work, but in Garry's code he's using os.date("*t").var and that does work.
