HPlogo MPE/iX Intrinsics Reference Manual > Chapter 9 Command Definitions (MAIL-PUTJCW)

NLCONVCLOCK

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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:

BitsValue/Meaning
8:8Minute of hour
0:8Hour 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:

ValueMeaning
0Successful
1*NLS not installed
2*Specified language not configured
3Invalid time string
4Invalid length
5*NLS internal error
6*NLS internal error

* Does not apply to calls with a langnum equal to 0 (NATIVE3000/XL).

Related Information


Intrinsics NLCONVCUSTDATE, NLFMTCALENDAR, NLFMTCLOCK, NLFMTCUSTDATE, NLFMTDATE, NLFMTLONGCAL
Manuals Native Language Programmer's Guide




NLCOLLATE2


NLCONVCUSTDATE