HP 3000 Manuals

Formatted Timer Information Intrinsics [ Getting System Information Programmer's Guide ] MPE/iX 5.0 Documentation


Getting System Information Programmer's Guide

Formatted Timer Information Intrinsics 

The following intrinsics enable you to take the information returned by
one of the system timer intrinsics, and format it so that it can be
displayed.  If you do not need to display this information, you can use
one of the system timer intrinsics by itself.

FMTCLOCK 

The FMTCLOCK intrinsic takes the information returned by CLOCK and
returns it in the following format:

     11:43 AM

There are two required parameters.  You pass the time of day in time, and
the formatted value is returned in string.  If the hour is a single
digit, the string contains a leading blank.

FMTCALENDAR 

The FMTCALENDAR intrinsic takes the information returned by CALENDAR and
returns it in the following format:

     FRI, JUN 13, 1986

There are two required parameters.  You pass the date in date, and the
formatted calendar date is returned in string.  If the day of the month
is a single digit, it is preceded by an additional blank.

FMTDATE 

The FMTDATE intrinsic takes the information returned by the CLOCK and
CALENDAR intrinsics and returns it in the following format:

     FRI, JUN 12, 1992, 11:43 AM

There are three required parameters.  You pass the date and time in date 
and time, and the formatted date and time are returned in string.  As
with the intrinsics described above, if the hour or date is a single
digit, it is preceded by an additional blank.

DATELINE 

The DATELINE intrinsic works like a combination of CLOCK, CALENDAR, and
FMTDATE. When you call this intrinsic, it returns the current date and
time, formatted as they are with FMTDATE. The intrinsic call contains a
single required parameter, datebuf, in which the formatted date and time
are returned.

SHOWTIME 

This command, often used by programmers whose watches are broken, works
like the intrinsic DATELINE. It is entered without parameters.  For
example:

     :SHOWTIME 
     FRI, OCT  3, 1986,  3:10 PM

Note, again, that dates and hours that are a single digit are preceded by
an extra blank.



MPE/iX 5.0 Documentation