HP 3000 Manuals

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


MPE/iX Intrinsics Reference Manual

NLFMTCUSTDATE 

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     Year of century

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

Commands              None

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



MPE/iX 5.0 Documentation