Format date/time string

This function is obsolete. The C style formatting is slow and has other problems. Use str.timeformat.

 

Syntax1 - standard date/time string

s.time([date])

 

Syntax2 - C style date/time string

s.time([date] cfrm [locale] [plusnseconds])

 

Syntax3 - Windows style date/time string

s.time([date] winfrmdate [winfrmtime])

 

Parameters

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.

 

Remarks

To insert this function, can be used the Text dialog from the floating toolbar.

 

Syntax1

Formats date/time string for current locale.

 

Syntax2

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.

 

Syntax3

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.