Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

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(5) 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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/core-os
Interface Stability
Committed
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.