NLFMTDATE

Syntax

             U16V  I32V  CA      I16V     U16A
  NLFMTDATE (date, time, buffer, langnum, error);

Parameters

date

16-bit unsigned integer by value (required)

Contains the date format returned by the CALENDAR intrinsic:

Bits

Value/Meaning

7:9

Day of year

0:7

Years since 1900

time

32-bit signed integer by value (required)

Contains the time to be formatted, returned by the CLOCK intrinsic:

Bits

Value/Meaning

8:8

Minutes of hour

0:8

Hour of day

buffer

character array (required)

Returns the formatted date and time in a 28 byte array. Using a buffer of a different size may produce unexpected results.

langnum

16-bit signed integer by value (required)

Contains the language ID number, specifying the formatting templates to use. A langnum of 0 returns the date/time string as if FMTDATE were used (for example, MON, FEB 7, 1983 9:00 AM).

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 value

4

Invalid time value

5

*NLS internal error

6

*NLS internal error

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

Related Information

Intrinsics

NLCONVCLOCK, NLCONVCUSTDATE, NLFMTCALENDAR, NLFMTCLOCK, NLFMTCUSTDATE, NLFMTLONGCAL

Manual

Native Language Programmer's Guide