This is a subset of the documentation, following the update to v3.0.0
Custom timestamp formatting
When the Date format is set to Custom, the timestamp of each log entry will be formatted using the format string.
Where time components are specified, they will be in local time.
The format string may contain any combination of regular characters, and special formatting codes which are preceded by a percent (%) sign as follows:
| Specifier | Replaced by | Example |
|---|---|---|
%a |
Abbreviated weekday name appropriate for locale | Thu |
%A |
Full weekday name appropriate for locale | Thursday |
%b |
Abbreviated month name appropriate for locale | Aug |
%B |
Full month name appropriate for locale | August |
%c |
Date and time representation appropriate for locale | Thu Aug 23 14:55:02 2001 |
%#c |
Long date and time representation appropriate for locale | Thursday, August 23, 2001, 14:55:02 |
%C |
First two digits of the year (00-99) |
20 |
%d |
Day of the month, zero-padded (01-31) |
23 |
%D |
Short MM/DD/YY date, equivalent to %m/%d/%y.Americans should note that in other countries %d/%m/%y is common. This means that in an international context this format is ambiguous and should not be used. |
08/23/01 |
%e |
Day of the month, space-padded ( 1-31) |
23 |
%f |
Fractional seconds, expressed as milliseconds (000-999).NOTE: This is a non-standard extension specific to SimpleActivityLogger. If used then it must only appear once. |
123 |
%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 |
Abbreviated month name appropriate for locale (same as %b) |
Aug |
%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 appropriate for locale | 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 (00-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 appropriate for locale | 08/23/01 |
%#x |
Long date representation appropriate for locale | Thursday, August 23, 2001 |
%X |
Time representation appropriate for locale | 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 appropriate for locale If timezone cannot be determined, no characters |
CDT |
%% |
A literal percent sign | % |
Additionally, various locale-specific modifiers can also be inserted between the percent sign (%) and the special formatting code in order to request an alternative format, where applicable:
| Modifier | Meaning | Applies to |
|---|---|---|
E |
Use the locale’s alternative representation | %Ec %EC %Ex %EX %Ey %EY |
O |
Use the locale’s alternative numeric symbols | %Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy |
# |
Remove leading zeroes, if any | %#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y |
The above formatting codes (with the exception of %f, which is a non-standard extension specific to SimpleActivityLogger) correspond to the C++ function strftime, for which many examples are available online.