Wyx dictionary

.PARAMETER...: /C - Custom Output Date Formats
.CATEGORY....: parameters
.DISCUSSION..:
The CUSTOM OUTPUT FORMAT parameter (/C) is designed to be more flexible than Fdate's original OUTPUT DATE FORMAT parameter (/O). You may specify the /C parameter in conjunction with any Fdate function that produces a date or time as its output. The /C parm allows you to specify any desired output string, with components of the date and time inserted into the string in any place where they are desired.

The first character of the /C parm is taken to be the character that you want to use as the ESCAPE CHARACTER. Starting with character 2, the string specified on the /C parm is processed.

When an escape character is found, the next character will be processed as an INSERT CODE -- a character that indicates that a special value is to be inserted into the output string. If the INSERT CODE is the same as the escape character, the escape character is inserted. Otherwise, one of the following values is inserted. Note that these values for the insert code are case-sensitive. Upper-case and lower-case codes are related, with the lower-case code inserting a string that is generally shorter than the one inserted by the upper-case code.

DEBUGGING TIP

If you are having problems with your custom output format, make sure that the first character in the /C parm is the escape character. If the first thing in your output string is an insert code, then the string should start with TWO escape characters, one to define the escape character, and one to identify the insert code. For instance, to produce the current 4-digit year, you would code:

    fdate /ff  /c"~~Y"

J - JJJ Business Julian date with leading zeros (1999/009)
j - zzJ Business Julian date without leading zeros (1999/9)
Y - 4-digit year (1999)
y - 2-digit year (99)
A - time in AM/PM format with a space between the minute and am/pm (09:04 am)
a - time in AM/PM format with no space preceding the am/pm (09:04am)
D - Day of month with leading zeros (09)
d - Day of month without leading zeros (9)
M - Month number with leading zeros (09)
m - Month number without leading zeros (9)
I - Long ISO date (ccyy-mm-dd) (1999-09-09)
i - Short ISO date (ccyymmdd) (19990909)
T - Long ISO time (hh:mm:ss) (09:09:09)
t - Short ISO time (hhmmss) (090909)
H - Hour with leading zeros (09)
h - Hour without leading zeros (9)
R - am/pm hour with leading zeroes
r - am/pm hour without leading zeroes
Q - "am" or "pm", depending on the time
U - minUte with leading zeros (09)
u - minUte without leading zeros (9)
S - Second with leading zeros (09)
s - Second without leading zeros (9)
C - Hundredth of second with leading zeros (09)
c - Hundredth of second without leading zeros (9) Values for hundredths of a second are not available in a file timestamp, so this value will always be zero when displaying information from a file timestamp.
N - Name of month (January)
n - Name of month, left 3 characters (Jan)
W - Name of day-of-week (Wednesday)
w - Name of day-of-week, left 3 characters (Wed)
# - Day-of-week number
L - Leapyear flag (1=leapyear, 0= non-leapyear)

The results of an escape character followed by any other character are undefined. (This is to allow for the addition of future insert codes.)

.EXAMPLE.....:

   (The tilde "~" is used as the escape character)
   On April 4, 1999, the following statement:
      Fdate /Ff /c"~Today is ~W, ~N ~d, ~Y (ISO date ~Y-~M-~D)"
   produces: "Today is Sunday, April 4, 1999 (ISO date 1999-04-04)"

.NOTE........:
The names of the days and the months are controlled by the language parameter (/L), and will vary with the language. For examples, run CUSTOM.BAT.