HP 3000 Manuals

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


MPE/iX Intrinsics Reference Manual

NLFMTDATE 

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:

                         Bits     Value/Meaning 

                          7:9     Day of year

                          0:7     Year of century

time                  32-bit signed integer by value (required) 

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

                         Bits     Value/Meaning 

                          8:8     Minutes of hour

                          0:8     Hour 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:

                         Value    Meaning 

                           0      Successful

                           1      *NLS not installed

                           2      *Specified language not configured

                           3      Invalid date value

                           4      Invalid time 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, NLFMTCUSTDATE, NLFMTLONGCAL

Commands              None

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



MPE/iX 5.0 Documentation