Creates a string based on the current SA version, filename, or date/time information.
0 |
System String |
String Content |
The information to carry in the string: SA Version, XIT Filename, MP Filename, MP Filename (Full Path), Date & Time, Date, Date (Short), Time |
1 |
String |
Format String (Optional) |
A custom format string (see Remarks below). |
2 |
String |
Resultant String |
The resulting string value. |
SUCCESS |
This command always succeeds. |
FAILURE |
An invalid user-formatted string was entered. |
The optional format string is used if the String Content argument is set to Date & Time, Date, Date (Short), or Time. If the format string is left blank in these cases, the default format is used.
Valid values for the format string include:
%a. Abbreviated weekday name
%A. Full weekday name
%b. Abbreviated month name
%B. Full month name
%c. Date and time representation appropriate for locale
%#c. Long date and time representation, appropriate for the current locale. For example, “Tuesday, March 14, 1995, 12:41:29”.
%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 AM/PM 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-53)
%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-53)
%x. Date representation for the current locale.
%#x. Long date representation, appropriate to the current locale. For example: “Tuesday, March 14, 1995”.
%X. Time representation for the current locale.
%y. Year without century, as decimal number (0-99)
%Y. Year with century, as decimal number.
%z, %Z. Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown.
%%. Percent sign
Use %#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, and %#Y to remove leading zeroes from the re- spective numbers (if applicable).