This function is obsolete. The C style formatting is slow and has other problems. Use str.timeformat.
s.time([date])
s.time([date] cfrm [locale] [plusnseconds])
s.time([date] winfrmdate [winfrmtime])
s - str variable.
date - variable of type DATE. Default: use current date.
cfrm - format-control string in C style.
locale - desired language. String. Default: "" (current locale).
plusnseconds - number of seconds to add. Can be negative. Default: 0.
winfrmdate - date part of format-control string in Windows style. If "", uses default format. If "-", uses only time part.
winfrmtime - time part of format-control string in Windows style. If "", uses default format. If "-" or omitted, uses only date part.
To insert this function, can be used the Text dialog from the code toolbar.
Formats date/time string for current locale.
Formats date/time string in C style. This style is selected at run time if format-control string contains % characters. The cfrm consists of one or more codes, preceded by a percent sign (%). Characters that do not begin with % are copied unchanged. The formatting codes are listed below:
| %a | Abbreviated weekday name |
| %A | Full weekday name |
| %b | Abbreviated month name |
| %B | Full month name |
| %c | Date and time representation appropriate for locale |
| %d | Day of month as decimal number (01 - 31) |
| %H | Hour in 24-hour format (00 - 23) |
| %I | Hour in 12-hour format (01 - 12) |
| %j | Day of year as decimal number (001 - 366) |
| %m | Month as decimal number (01 - 12) |
| %M | Minute as decimal number (00 - 59) |
| %p | Current locale's A.M./P.M. indicator for 12-hour clock |
| %S | Second as decimal number (00 - 59) |
| %U | Week of year as decimal number, with Sunday as first day of week (00 - 51) |
| %w | Weekday as decimal number (0 - 6; Sunday is 0) |
| %W | Week of year as decimal number, with Monday as first day of week (00 - 51) |
| %x | Date representation for current locale |
| %X | Time representation for current locale |
| %y | Year without century, as decimal number (00 - 99) |
| %Y | Year with century, as decimal number |
| %z, %Z | Time-zone name or abbreviation; no characters if time zone is unknown |
| %% | Percent sign |
The # flag may prefix any formatting code. In that case, the meaning of the format code is changed as follows.
| %#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#% | # flag is ignored. |
| %#c | Long date and time representation, appropriate for current locale. For example: "Tuesday, March 14, 1995, 12:41:29". |
| %#x | Long date representation, appropriate to current locale. For example: "Tuesday, March 14, 1995". |
| %#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y | Remove leading zeros (if any). |
locale (language) affects, how string is formatted. Locale string can be found in Control Panel Regional Settings.
Formats date/time string in Windows style. This style is selected at run time if format-control string does not contain % characters. Below listed character sequences in format-control strings are replaced with year, month, etc values. Other characters are copied unchanged. To prevent character replacement, enclose it in single quotation marks.
winfrmdate:
| d | Day of month as digits. |
| dd | Day of month as digits with leading zero for single-digit days. |
| ddd | Day of week as a three-letter abbreviation. |
| dddd | Day of week as its full name. |
| M | Month as digits. |
| MM | Month as digits with leading zero for single-digit months. |
| MMM | Month as a three-letter abbreviation. |
| MMMM | Month as its full name. |
| y | Year as last two digits, but with no leading zero for years less than 10. |
| yy | Year as last two digits, but with leading zero for years less than 10. |
| yyyy | Year represented by full four digits. |
| gg | Period/era string. |
winfrmtime:
| h | Hours with no leading zero for single-digit hours; 12-hour clock. |
| hh | Hours with leading zero for single-digit hours; 12-hour clock. |
| H | Hours with no leading zero for single-digit hours; 24-hour clock. |
| HH | Hours with leading zero for single-digit hours; 24-hour clock. |
| m | Minutes with no leading zero for single-digit minutes. |
| mm | Minutes with leading zero for single-digit minutes. |
| s | Seconds with no leading zero for single-digit seconds. |
| ss | Seconds with leading zero for single-digit seconds. |
| t | One character time-marker string, such as A or P. |
| tt | Multicharacter time-marker string, such as AM or PM. |
The function cannot format milliseconds.