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:

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




NLCOLLATE2


NLCONVCUSTDATE