cal - Displays a calendar
cal [month [year]]
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Names the month for which you want the calendar. It can
be a number between 1 and 12 for January through December,
respectively. If month is not specified, cal displays a
calendar for the entire year, unless year is also omitted.
Names the year for which you want the calendar. Because
cal can display a calendar for any year from 1 to 9999,
enter the full year rather than just the last two digits.
If year is not specified, cal uses the current year.
If no operands are specified, cal displays a calendar for
the current month.
The cal command writes to standard output a Gregorian calendar
for the specified year or month.
For historical reasons, the cal command's Gregorian calendar
is discontinuous. The display for September 1752 (cal
9 1752) jumps from Wednesday the 2nd to Thursday the 14th.
The cal command checks the LC_TIME environment variable
and uses the correct headers for the current locale. If
LC_TIME is not set, cal checks the value of LANG. If neither
variable is set, you receive English headers.
The following exit values are returned: Successful completion.
An error occurred.
To display a calendar for February 1990, enter: cal 2 1990
To display a calendar for the year 84 A.D., enter: cal 84
To display a calendar for the current month, enter: cal
ENVIRONMENT VARIABLES [Toc] [Back]
The following environment variables affect the execution
of *cmd*: Provides a default value for the internationalization
variables that are unset or null. If LANG is unset
or null, the corresponding value from the default locale
is used. If any of the internationalization variables
contain an invalid setting, the utility behaves as if none
of the variables had been defined. If set to a non-empty
string value, overrides the values of all the other internationalization
variables. Determines the locale for the
interpretation of sequences of bytes of text data as characters
(for example, single-byte as opposed to multibyte
characters in arguments). Determines the locale for the
format and contents of diagnostic messages written to
standard error. Determines the format and contents of the
calendar. Determines the location of message catalogues
for the processing of LC_MESSAGES. Determines the time
zone used to calculate the value of the current month.
Command and Shell User's Guide
[ Back ]