[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    cal(1) manual page Table of Contents

Name

cal - display a calendar

Synopsis

cal [ [ month ] year ]

Availability

SUNWesu

Description

The cal utility writes a Gregorian calendar to standard output. 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

See environ(5) for descriptions of the following environment variables that affect the execution of cal: LC_TIME, LC_MESSAGES, and NLSPATH.

Exit Status

The following exit values are returned:
  1. Successful completion.
    >0
    An error occurred.

    See Also

    calendar(1) , environ(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.


    Table of Contents