MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 7 337
Command Definitions (HP32208-HPLOACNMPROC)
HPDATEFORMAT
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 .
If an invalid date is passed, on return from the intrinsic its
contents will be "UNKNOWN." For the "HP Standard Formats," if
special values in the table, "Special Date Values," are passed
for date parameter, on return from the intrinsic, the value of
the string will be appropriately initialized. For example, for
the date type 18, the initialized values for different special
date values are as follows:
Date Value Returned Contents
00000000 “UNKNOWN"
00000101 “INVALID"
00000102 “NEVER"
00000103 “NEEDED"
00000104 “EXPIRED"
00000105 “ILLEGAL"
If the character array passed does not have enough space to
hold the special values or the formatted date, the behavior is
undefined.
fmtdatelen is a 32 bit integer by reference (required).
On input, it is the length of the
formatspec parameter.
On return, it represents the number of characters HPDATEFORMAT
placed into
fmtdate .
status is the HPE_STATUS parameter through which the error codes are
returned. A value of 0 indicates no errors and no warnings.
cutoff is a 32 bit signed integer by value (optional).
This is used in validating and converting the two-digit years
to four digit ones before computing the difference. (See
HPDATECONVERT documentation for more information.)
Operation Notes
Related Information
Intrinsics HPCALENDAR, HPDATECONVERT, HPDATEDIFF, HPDATEOFFSET,
HPDATEVALIDATE, HPFMTCALENDAR