HP 3000 Manuals

NLFMTCALENDAR [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

NLFMTCALENDAR 

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:

                         Bits     Value/Meaning 

                          7:9     Day of year

                          0:7     Year of century

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:

                         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, NLFMTCLOCK,
                      NLFMTCUSTDATE, NLFMTDATE, NLFMTLONGCAL

Commands              None

Manuals               Native Language Programmer's Guide (32650-90022)



MPE/iX 5.0 Documentation