|
|
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 U16A
time := NLCONVCLOCK (buffer, bufferlength, langnum, 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
- Manual
Native Language Programmer's Guide
|