OS Manuals

/usr/bin/cal

Misc binaries for util-linux

From util-linux-misc 2.42.4-r2 (os), captured 2026-11-05 by running cal --help (exit 0). permalink

Usage:
 cal [options] [[[day] month] year]
 cal [options] <timestamp|monthname>

Display a calendar, or some part of it.
Without any arguments, display the current month.

Options:
 -1, --one             show only a single month (default)
 -3, --three           show three months spanning the date
 -n, --months <num>    show num months starting with date's month
 -S, --span            span the date when displaying multiple months
 -s, --sunday          Sunday as first day of week
 -m, --monday          Monday as first day of week
 -j, --julian          use day-of-year for all calendars
     --reform <val>    Gregorian reform date (1752|gregorian|iso|julian)
     --iso             alias for --reform=iso
 -y, --year            show the whole year
 -Y, --twelve          show the next twelve months
 -w, --week[=<num>]    show US or ISO-8601 week numbers
 -v, --vertical        show day vertically instead of line
 -c, --columns <width> amount of columns to use
     --color[=<when>]  colorize messages (auto, always or never)
                         colors are enabled by default

 -h, --help            display this help
 -V, --version         display version

For more details see cal(1).
Options (17)
OptionDescriptionSource
-1, --oneshow only a single month (default)help + man
-3, --threeDisplay three months spanning the date.help + man
-n, --months numDisplay number of months, starting from the month containing the date.help + man
-S, --spanspan the date when displaying multiple monthshelp + man
-s, --sundayDisplay Sunday as the first day of the week.help + man
-m, --mondayDisplay Monday as the first day of the week.help + man
-j, --julianUse day-of-year numbering for all calendars.help + man
--reform valThis option sets the adoption date of the Gregorian calendar reform.help + man
--isoDisplay the proleptic Gregorian calendar exclusively.help + man
-y, --yearDisplay a calendar for the whole year.help + man
-Y, --twelveDisplay a calendar for the next twelve months.help + man
-w, --week numDisplay week numbers in the calendar according to the US or ISO-8601 format.help + man
-v, --verticalDisplay using a vertical layout (aka ncal(1) mode).help + man
--color whencolorize messages (auto, always or never) colors are enabled by defaulthelp + man
-h, --helpDisplay help text and exit.help + man
-V, --versionDisplay version and exit.help + man
-c, --columns columnsNumber of columns to use. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.