cal — display a calendar
SYNOPSIS
cal [-3] [[month] year]
DESCRIPTION
Displays the current month as a text grid, weeks starting on Monday (ISO 8601), with today highlighted. Given a month and a year, shows that month; given a year alone, shows the whole year, three months per row. Week numbers (ISO) are shown on the left.
OPTIONS
-3 show the previous, current and next month side by side
HOW IT WORKS
The grid follows the ISO 8601 conventions used in Europe: weeks start on Monday and are numbered so that week 1 is the week containing the year's first Thursday. Days come from your browser's clock and time zone, so "today" is highlighted in your local time.
USE CASES
- check the day of the week of a date, or the week number for planning;
- look up a whole year at a glance (cal 2026);
- see the previous, current and next month side by side (cal -3).
NOTES
Like the Unix cal command, the output is plain text: pipe it or redirect it to a file, e.g. cal 2026 > year.txt.
EXAMPLES
cal cal 2 2028 cal 2026 cal -3