CAL(1) User Commands CAL(1)

NAME

cal - display a calendar

SYNOPSIS

cal [ [month] year]

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 VARIABLES

See environ(7) for descriptions of the following environment
variables that affect the execution of cal: LANG, LC_ALL, LC_CTYPE,
LC_TIME, LC_MESSAGES, 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.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+

SEE ALSO

attributes(7), environ(7), standards(7)

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.

March 7, 2017 CAL(1)