NLCONVCLOCK [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
NLCONVCLOCK
NM and CM callable.
Converts the time format from a character string to numeric value; checks
the input string using the formatting template returned by itemnum=3 of
the NLINFO intrinsic, then converts the time to the general time format
returned by the CLOCK intrinsic.
Syntax
_____________________________________________________
| |
| I32 CA I16V I16V |
| time:=NLCONVCLOCK(buffer,bufferlength,langnum,|
| U16A |
| error); |
_____________________________________________________
Functional Return
time 32-bit signed integer (assigned functional return)
Returns the time in the following format:
Bits Value/Meaning
8:8 Minute of hour
0:8 Hour of day
Parameters
buffer character array (required)
Passes the formatted time to be converted.
bufferlength 16-bit signed integer by value (required)
Passes the length of buffer (in bytes).
langnum 16-bit signed integer by value (required)
Contains the language ID number, specifying the
custom time format for buffer.
error 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 number values
are:
Value Meaning
0 Successful
1 *NLS not installed
2 *Specified language not configured
3 Invalid time string
4 Invalid length
5 *NLS internal error
6 *NLS internal error
* Do not apply to calls with a langnum equal to 0
(NATIVE3000/XL).
Related Information
Intrinsics NLCONVCUSTDATE, NLFMTCALENDAR, NLFMTCLOCK,
NLFMTCUSTDATE, NLFMTDATE, NLFMTLONGCAL
Commands None
Manuals Native Language Programmer's Guide (32650-90022)
MPE/iX 5.0 Documentation