Continuously displays the time at desired screen position


     ShowTime([<nRow>], [<nColumn>], [<lMode>],
        [<cAttr|nAttr>], [<l12/24>], [<lAM/PM>]) --> cNull


     <nRow>  Designates the row where the time is displayed.  The default
     is the cursor row.

     <nColumn>  Designates the column where the time is displayed.  The
     default is the cursor column.

     <lMode>  Designates whether seconds are to appear in the time
     display (.F.), or not (.T.).  The default is display seconds (.F.).

     <cAttr|nAttr>  Designates to the screen attribute to use for the
     time display.  Strings in the form "NN/NN" or "CC/CC" (e.g., "0/7" or
     "B/GR") are possible.  The default is the setting for CLEARA (see
     Introduction, Video Functions).

     <l12/24>  By designating this parameter as .T., a 12-hour display is
     selected.  The default is a 24-hour display (.F.).

     <lAM/PM>  If you have a 24-hour display, you may want to switch on
     an am/pm display.  When you specify this parameter as .T., an "a" or "p"
     (as in DOS), appears to reflect the time.  The default is no display

     ()  A call without parameters uninstalls the time display.


     ShowTime() always returns a null string.


     This function permits you to constantly display the time in any screen
     position desired. ShowTime() is interrupt controlled and has the ability
     to display the time in either "hh:mm:ss" or "hh:mm" format.  A 12- or 24     -hour display can be selected, with or without an am/pm display.


     Warning!  ShowTime() works with the interrupt system.  Before
     leaving your Clipper application, you must uninstall ShowTime() , so
     that the interrupt vectors can be restored.  Otherwise, the system will
     be unstable and will eventually crash.  Simultaneous use of the
     accompanying Extended Drivers Modules automatically restores the
     interrupt vectors in use.

     .  Specify the screen attribute as either a numeric or a string
        in "NN/NN" form.  If no attribute is specified, the value for CLEARA
        applies (see Introduction Video Functions).


     .  Display a clock in row 0, column 70, with no seconds display
        and the standard attribute.  When a display is shown in row 0, switch
        SCOREBOARD off!

        ShowTime(0, 70, .T.)      //  Turn on clock
        SHOWTIME()                //  Uninstall clock

     .  Show a 12-hour display with am/pm on the lowest row.  White
        letters on a blue background:

        ShowTime(24, 70, .T., "W/B")

Tools — Date/Time Functions

Introduction Date/Time Functions
ADDMONTH()   Adds or subtracts months to/from a date
BOM()        Determines the date of the first day of a month
BOQ()        Determines the date for the beginning of a quarter
BOY()        Determines the date for the beginning of a year
CTODOW()     Converts the day of the week name into a corresponding number
CTOMONTH()   Converts the name of the month into a corresponding number
DMY()        Returns a date in "DD Month YY" format
DOY()        Determines the day of the year for a specific date
EOM()        Determines the date for the last day of a month
EOQ()        Determines the date for the end of a quarter
EOY()        Determines the date for the end of the year
ISLEAP()     Tests if a specific year is a leap year
LASTDAYOM()  Determines the number of days in a month
MDY()        Returns a date in the "Month DD, YY" format
NTOCDOW()    Changes the number of a weekday into a weekday name
NTOCMONTH()  Changes the number of a month into a month name
QUARTER()    Determines the quarter in which a specific date lies
SECTOTIME()  Converts seconds into a time string
SETDATE()    Sets the system date
SETTIME()    Sets the system clock
SHOWTIME()   Continuously displays the time at desired screen position
STOD()       Converts an ANSI date string into Clipper format
TIMETOSEC()  Calculates the seconds since midnight
TIMEVALID()  Determines whether a specified time is valid
WAITPERIOD() Pauses a specified time in increments of 1/100 seconds
WEEK()       Returns the calendar week for a date
WOM()        Returns the week within a month.