MPE/iX Intrinsics Reference Manual (32650-90875)
50 Chapter4
Command Definitions (ABORTSESS - FCLOSE)
ALMANAC
ALMANAC
NM and CM callable.
Returns the numeric date information for a date returned by the CALENDAR intrinsic. The
returned information is year of century, month of year, day of month, and day of week.
Syntax
U16V U16A I16 I16
ALMANAC(
date,daterror
,
yearnum,monthnum,
I16 I16
daynum,weekdaynum
);
Parameters
date
16-bit unsigned integer by value (required)
Contains the date in the following format:
Bits Value/Meaning
7:9 Day of year
0:7 Years since 1900
d
4
aterror
16-bit unsigned integer array (required)
Returns two elements; the first element is the error number, the second
element is reserved and always returns 0. The possible error numbers
returned are:
Value Meaning
0
Successful
1 No parameters available for returning values
2 Day of year out of range
3 Year of century out of range
yearnum
16-bit signed integer by reference (optional)
Returns the year of century. For example, 00=1900, 84=1984.
monthnum
16-bit signed integer by reference (optional)
Returns the month of year. For example, 1=January, 12=December.
daynum
16-bit signed integer by reference (optional)
Returns the day of month.
weekdaynum
16-bit signed integer by reference (optional)
Returns the day of week. For example, 1=Sunday, 7=Saturday.