User Commands                                              cal(1)



NAME
     cal - display a calendar

SYNOPSIS
     cal [ [month] year]


DESCRIPTION
     The cal utility writes a Gregorian calendar to standard out-
     put.  If  the year operand is specified, a calendar for that
     year is written. If no operands are  specified,  a  calendar
     for the current month is written.

OPERANDS
     The following operands are supported:

     month    Specify the month to be displayed, represented as a
              decimal  integer from 1 (January) to 12 (December).
              The default is the current month.


     year     Specify  the  year  for  which  the   calendar   is
              displayed,  represented as a decimal integer from 1
              to 9999. The default is the current year.


ENVIRONMENT VARIABLES
     See  environ(5) for descriptions of the  following  environ-
     ment  variables  that  affect  the  execution  of cal: LANG,
     LCAL, LCTYPE, LCTIME, LCMESAGES, and NLSPATH.

     TZ    Determine the timezone used to calculate the value  of
           the current month.


EXIT STATUS
     The following exit values are returned:

     0     Successful completion.


     >0    An error occurred.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








SunOS 5.11           Last change: 1 Feb 1995                    1






User Commands                                              cal(1)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWesu                     
    
     Interface Stability          Standard                    
    


SEE ALSO
     calendar(1), attributes(5), environ(5), standards(5)

NOTES
     An unusual calendar is printed for September 1752.  That  is
     the  month  11 days were skipped to make up for lack of leap
     year adjustments. To see this calendar, type:

       cal 9 1752




     The command cal 83 refers to the year 83, not 1983.


     The year is always considered to start in January.





























SunOS 5.11           Last change: 1 Feb 1995                    2