Communicator 3000 MPE/iX Release 6.0 (Platform Software Release C.60.00) (30216-90269)

130 Chapter 9
Year 2000 Enhancements
New Date Intrinsics for MPE/iX
Table 9-7 Valid Characters for Punctuation
Thus, YYYY.MON.DAY, YY/MM/DD, DDMONYY, and DD-ZMM-YYYY are
valid date formats. For example, “31 Jan 1997” when formatted through
DD-ZMM-YYYY results in “31-1-1997,” formatted through
YYYY.MON.DAY results in “1997.JAN.FRI,” while YYYYMMDD results in
“19970131.”
NOTE Mixing the NULL punctuation character with other punctuation
characters is not allowed. Thus, YYYY/MM/DD is a valid format, while
YYYYMM/DD is not. fmtdatelen parameter is length of formatspec
parameter including the null termination character.
Syntax
I32V * CA CA I32 I32 I32V
HPDATEFORMAT(datecode,inputdate,formatspec,fmtdate,fmtdatelen,status,cutoff)
Parameters
datecode is a 32-bit signed integer by value.
This value should be one of the date type codes listed in
the table, “Supported Date Formats.”
inputdate is the input date.
The interpretation depends upon the value of datecode.
See the table, “Supported Date Formats,” for the
supported datecodes and their layouts.
formatspec is a character array (required).
This should be a NULL terminated string as per the
syntax explained above in the table, “Format
Specification Strings.”
fmtdate is a character array (required).
This array size should be at least that of formatspec. On
return, it will contain the date formatted as per the
formatspec.
- Hyphen
/ Slash
. Dot
Blank
, Comma
Null (or no delimiter)