CAL(1) | General Commands Manual | CAL(1) |
cal
—
cal |
[-jmwy ] [month]
[year] |
cal
displays a simple calendar. Calendars may be
displayed by month or by year.
The options are as follows:
-j
-j
and -w
are
mutually exclusive.-m
-w
-m
is specified the ISO week format is assumed. The options
-j
and -w
are mutually
exclusive.-y
A single numerical parameter specifies the
year (1 - 9999) to be displayed. 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 parameter
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 reformation (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.
cal
utility exits 0 on success,
and >0 if an error occurs.
cal
utility is compliant with the
X/Open Portability Guide Issue 4
(“XPG4”) specification.
The flags [-jmwy
] are extensions to that
specification.
The week number computed by -mw
is
compliant with the ISO 8601 specification.
cal
command appeared in
Version 6 AT&T UNIX.September 16, 2011 | OpenBSD-5.1 |