cal1
Displays a calendar
Usage
cal [-jmwy]
[month]
[year]
Overview
cal displays a simple calendar. Calendars may be displayed by month or by year.
The options are as follows:
-
-j -
Display Julian dates (days one-based, numbered from January 1). The options
-jand-ware mutually exclusive. -
-m -
Display weeks starting on Monday instead of Sunday.
-
-w -
Display week numbers in the month display. If
-mis specified, the ISO week format is assumed. The options-jand-ware mutually exclusive. -
-y -
Display a calendar for the current year. This option is ignored if year is specified and conflicts with specifying a month.
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 1900s). Eleven days following that date were eliminated by the Reformation, so the calendar for that month is a bit unusual.
Exit status
The cal utility exits 0 on success, and >0 if an error occurs.
Releases
61 releases since OpenBSD 2.1; the text changed 18 times.
- 2.1
- 2.2
- 2.3
- 2.4–2.5
- 2.6
- 2.7–3.3
- 3.4–3.8
- 3.9–4.1
- 4.2–4.3
- 4.4
- 4.5–4.7
- 4.8
- 4.9–5.0
- 5.1–5.4
- 5.5–6.0
- 6.1–7.0
- 7.1–7.5
- 7.6–7.9
- 8.0
-m since OpenBSD 4.4;
-w since OpenBSD 4.4.