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

NLFMTCALENDAR

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Formats the date according to language-dependent templates. The formatting is done according to the template returned by itemnum= 1 of the NLINFO intrinsic.

Syntax



                 U16V  CA      I16V     U16A
  NLFMTCALENDAR (date, buffer, langnum, error);

Parameters


date

16-bit unsigned integer by value (required)

Contains the date format returned by the CALENDAR intrinsic:

BitsValue/Meaning
7:9Day of year
0:7Years since 1900

buffer

character array (required)

Returns the formatted date. This string is 18 characters long and is padded with blanks (if necessary). 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 calendar template to be used. A langnum of 0 returns the date formatted as if FMTCALENDAR were used (for example, FRI, OCT 1, 1982).

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 date value
5*NLS internal error
6*NLS internal error

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

Related Information


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




NLFINDSTR


NLFMTCLOCK