DT_Format¶
DT_Format generates a formatted string representation of the rmDate values.
- smRet = DT_Format(rmDate, ssFormat)
Return Value
smRet
Parameters
- rmDate
rmDate is a real matrix.
- ssFormat
ssFormat is a scalar string. The formatting string is similar to the printf formatting string. Formatting codes, preceded by a percent (%) sign, are replaced by the corresponding date/time component. Other characters in the formatting string are copied unchanged to the returned string. The value and meaning of the formatting codes for DT_Format are listed below:
Value
Meaning
%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 to 31)
%H
Hour in 24-hour format (00 to 23)
%I
Hour in 12-hour format (01 to 12)
%j
Day of year as decimal number (001 to 366)
%m
Month as decimal number (01 to 12)
%M
Minute as decimal number (00 to 59)
%p
Current locale’s A.M./P.M. indicator for 12-hour clock
%S
Second as decimal number (00 to 59)
%U
Week of year as decimal number, with Sunday as first day of week (00 to 51)
%w
Weekday as decimal number (0 to 6; Sunday is 0)
%W
Week of year as decimal number, with Monday as first day of week (00 to 51)
%x
Date representation for current locale
%X
Time representation for current locale
%y
Year without century, as decimal number (00 to 99)
%Y
Year with century, as decimal number
%z, %Z
Time zone name or abbreviation; no characters if time zone is unknown
%%
Percent sign
Comment
The format argument consists of one or more codes; as in printf, the formatting
codes are preceded by a percent sign (%). Characters that do not begin with % are
copied unchanged to strDest. The LC_TIME category of the current locale
affects the output formatting. (For more information on LC_TIME, see
DT_SetLocale.) The formatting codes are listed below:
As in the printf function, 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).
Example
* d = DT_GetCurrentTime()
* d
35992.3731
* DT_Format(d, "%c")
16.07.98 08:57:14
* DT_Format(d, "%#c")
Donnerstag, 16. Juli 1998 08:57:14
* DT_Format(d, "%x")
16.07.98
* DT_Format(d, "%X")
08:57:14
id-1118602