


            Date(V1.3, 2.x, 3.x) (Locatin C:))             


     NAME
            DATE - Set or display the system date.

     SYNOPSIS
          DATE Date Time TO=VER/k

     DESCRIPTION
            Date is used to set the systems idea of the current 
        date and time, or to display the systems idea of the 
        current date and time.

            To display the current system time simply use Date 
        with no arguments.  You may specify a TO or verification 
        file to send the date to, if no TO file is specified, the 
        date is displayed in the current window.

            To set the time you use the format HH:MM:SS where H 
        stands for hours, M stands for minutes, and S stands for 
        seconds.  Leading zeroes are optional for all versions 
        except 1.2.  1.2 requires that you include a leading zero 
        before the 10th month.

            Both the display of the date and the setting of the 
        date are determined by the 1.3 environment variable 
        'dateformat'. Under 2.x/3.x it is stored simply as 
        'name'. This veriable can be a file or an actual device 
        such as a printer. This determines one of several 
        international formats for displaying and setting the 
        date. If 'dateformat' is not set or if its value is zero, 
        the AmigaDOS format is used.  Here is a list of the legal 
        values for dateformat, and the corresponding input and 
        output formats:

            0    This is the default AmigaDOS format, DD-MMM-YY 
                 is used for both input and output.  Note that 
                 if datetime is undefined, or the value is 
                 illegal, this will be the default option.

            1    International format, YY-MM-DD is the format.

            2    USA format, MM-DD-YY is the format.

            3    Canadian format, DD-MM-YY is the format.

            Note that dateformat controls the format for the 
        input string as well as the output display.  You never 
        have to enter leading zeros, and you may always use words 
        like SATURDAY, YESTERDAY, TOMORROW, etc.

            Saturday, Sunday, Monday, and the rest of the days of 
        the week can be used as flags. The system will evaluate 
        the day then advance the system date to match the 
        specified day of the week. So, if it is Monday and you 
        specify Thursday, the system clock will advance by three 
        days.

            FOR 1.3 Only:  SETCLOCK is used in the 
        startup-sequence to automatically read the system's 
        hardware clock (if present).  The A1000 and A500 did not 
        come with a clock installed.  Therefor, AmigaDOS would 
        check the boot disk for the date of most recent file and 
        sets the system date according to that.  The Date command 
        is then used to set the proper date and time.  This was 
        lost anytime you rebooted the computer or utilized the 
        SETCLOCK SAVE command.

            FOR 2.x/3.x: The clock is read automatically by the 
        system without utilizing the SETCLOCK command. Therefor, 
        you will never see it listed anywhere.



     EXAMPLES
            1. To use default AmigaDOS format.

                 SET dateformat=0   

            2. To set the date, using AmigaDOS format

                 Date 1-jan-88  


            3. To set the date to the next day's date and the 
        time to 12:00

                  Date Tomorrow 12:00 

