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

NLFMTDATE

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Formats the date and time according to language-dependent templates returned by itemnums 1 and 3 of the NLINFO intrinsic.

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:

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

time

32-bit signed integer by value (required)

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

BitsValue/Meaning
8:8Minute of hour
0:8Hour 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:

ValueMeaning
0Successful
1*NLS not installed
2*Specified language not configured
3Invalid date value
4Invalid time 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, NLFMTCALENDAR, NLFMTCLOCK, NLFMTCUSTDATE, NLFMTLONGCAL
Manuals Native Language Programmer's Guide




NLFMTCUSTDATE


NLFMTLONGCAL