CAL(1)                  System General Commands Manual                  CAL(1)

NAME
     cal - displays a calendar

SYNOPSIS
     cal [-jy] [month] [year]

DESCRIPTION
     cal displays a simple calendar.  Calendars may be displayed by month or
     by year.

     The options are as follows:

     -j      Display Julian dates (days one-based, numbered from January 1).

     -y      Display a calendar for the current year.

     A single numerical parameter specifies the year (1 - 9999) to be dis-
     played.  The year must be fully specified: ``cal 89'' will not display a
     calendar for 1989.  Two parameters denote the month (1 - 12, or a month
     name or abbreviation thereof) and year.  Alternatively, a single parame-
     ter may be given specifying the name or abbreviated name of a month: in
     that case a calendar is displayed for that month of the current year.  If
     no parameters are specified, the current month's calendar is displayed.

     A year starts on January 1st.

     The Gregorian Reformation is assumed to have occurred in 1752 after the
     2nd of September.  By this time, most countries had recognized the refor-
     mation (although a few did not recognize it until the early 1900's).
     Eleven days following that date were eliminated by the reformation, so
     the calendar for that month is a bit unusual.

SEE ALSO
     calendar(1)

STANDARDS
     The cal command offers a superset of IEEE Std 1003.2 (``POSIX.2'') func-
     tionality.

HISTORY
     A cal command appeared in Version 6 AT&T UNIX.

Interix                          June 22, 2006                         Interix