|
|
NM and CM callable.
Formats the general date format returned by the CALENDAR intrinsic
into the custom date format for a native language. A custom date is an
abbreviated format such as 10/1/82 or 82.10.1. The formatting
is done according to the template returned by itemnum= 2 of the
NLINFO intrinsic.
Syntax
U16V CA I16V U16A
NLFMTCUSTDATE (date, 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
- buffer
character array (required)
Returns the formatted date in a 13-character 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 custom date template to
be used for formatting. A langnum of 0 returns the time
formatted as if FMTCLOCK were used.
- 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
- 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,
NLFMTDATE, NLFMTLONGCAL
- Manual
Native Language Programmer's Guide
|