cal - Display a calendar
$ cal [--starting-day weekday] [--three-month-view] [--year] [[month] year]
This program displays a simple calendar. If no arguments are specified, the current month is displayed with the current day highlighted. An overview of a whole year is displayed when a year
is passed without a month
.
The current day is always highlighted.
Months and years are specified with numbers. Weeks start at what's configured in the Calendar system settings, unless the --starting-day
option is passed.
Days, months and years are specified with numbers. Week starts at Sunday.
-s
, --starting-day
: Specify which day should start the week. Accepts either short or long weekday names or indexes (0 being Sunday).-3
, --three-month-view
: Display the previous, current, and next months side-by-side.-y
, --year
: Display an entire year by laying out months on a grid. If no year number is specified, the current year is used as a default.# Display the current month
$ cal
March - 2023
Su Mo Tu We Th Fr Sa
1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31
# Display any month
$ cal 1 1999
January - 1999
Su Mo Tu We Th Fr Sa
1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31
# Display three months side-by-side
$ cal -3 3 2023
February - 2023 March - 2023 April - 2023
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 2 3 4 1 2 3 4 1
5 6 7 8 9 10 11 5 6 7 8 9 10 11 2 3 4 5 6 7 8
12 13 14 15 16 17 18 12 13 14 15 16 17 18 9 10 11 12 13 14 15
19 20 21 22 23 24 25 19 20 21 22 23 24 25 16 17 18 19 20 21 22
26 27 28 26 27 28 29 30 31 23 24 25 26 27 28 29
# Display an entire year
$ cal 2023
Year 2023
January February March
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 2 3 4 5 6 7 1 2 3 4 1 2 3 4
8 9 10 11 12 13 14 5 6 7 8 9 10 11 5 6 7 8 9 10 11
15 16 17 18 19 20 21 12 13 14 15 16 17 18 12 13 14 15 16 17 18
22 23 24 25 26 27 28 19 20 21 22 23 24 25 19 20 21 22 23 24 25
29 30 31 26 27 28 26 27 28 29 30 31
April May June
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 1 2 3 4 5 6 1 2 3
2 3 4 5 6 7 8 7 8 9 10 11 12 13 4 5 6 7 8 9 10
9 10 11 12 13 14 15 14 15 16 17 18 19 20 11 12 13 14 15 16 17
16 17 18 19 20 21 22 21 22 23 24 25 26 27 18 19 20 21 22 23 24
23 24 25 26 27 28 29 28 29 30 31 25 26 27 28 29 30
30
July August September
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 1 2 3 4 5 1 2
2 3 4 5 6 7 8 6 7 8 9 10 11 12 3 4 5 6 7 8 9
9 10 11 12 13 14 15 13 14 15 16 17 18 19 10 11 12 13 14 15 16
16 17 18 19 20 21 22 20 21 22 23 24 25 26 17 18 19 20 21 22 23
23 24 25 26 27 28 29 27 28 29 30 31 24 25 26 27 28 29 30
30 31
October November December
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 2 3 4 5 6 7 1 2 3 4 1 2
8 9 10 11 12 13 14 5 6 7 8 9 10 11 3 4 5 6 7 8 9
15 16 17 18 19 20 21 12 13 14 15 16 17 18 10 11 12 13 14 15 16
22 23 24 25 26 27 28 19 20 21 22 23 24 25 17 18 19 20 21 22 23
29 30 31 26 27 28 29 30 24 25 26 27 28 29 30