NLCONVCUSTDATE

Syntax

  U16                     CA      I16V          I16V     U16A
  date := NLCONVCUSTDATE (buffer, bufferlength, langnum, error);

Functional Return

date

16-bit unsigned integer (assigned functional return)

Returns the date in the following format:

Value	Meaning
7:9	Day of year
0:7	Years since 1900

Parameters

buffer

character array(required)

Passes the formatted date to be converted into custom date format. Leading and trailing blanks are ignored.

bufferlength

16-bit signed integer by value (required)

Contains the length of buffer (in bytes).

langnum

16-bit signed integer by value (required)

Contains the language ID number, specifying the custom date 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 date string
4	Invalid length
5	*NLS internal error
6	*NLS internal error
7	Separator character in buffer does not match custom date template
8	Length of date string > 13 characters (excluding leading and trailing blanks)

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

NOTE: When a byte array is passed the code receives the starting position and the length. There is no way for the code to determine if the length you specifiy is correct. Therefore, an error of 4 (invalid string length) is returned only if the specified buffer length is 0 or a negative number. If the passed array length is greater than zero, but is still incorrect, unpredictable results can occur.

Related Information