Usage
pcal [OPTIONS] [MONTH] [YEAR]
By default pcal prints the current month. Positional arguments select a specific month and/or year; flags change the view.
Positional arguments
| Argument | Meaning |
|---|---|
MONTH | Month number (1–12), romanized name (mordad), or Persian script (مرداد). |
YEAR | Shahanshahi year, e.g. 2585. |
How arguments are interpreted:
pcal→ current month.pcal 5→ month 5 (Mordad) of the current year — a single value that parses as a month is treated as a month.pcal 2585→ the whole year 2585 — a single value that is not a valid month is treated as a year.pcal mordad 2585/pcal 5 2585→ Mordad 2585.
Options
| Flag | Description |
|---|---|
-3 | Show the previous, current, and next month side by side. |
-y, --year-view | Show all 12 months of the year. |
-n NUM | Show the next NUM months starting from the selected month. |
-j | Show day-of-year numbers instead of day-of-month. |
--persian, --fa | Use Persian script: month names, weekday letters, and digits. |
--no-color | Disable colored output (also honors the NO_COLOR env var). |
-h, --help | Print help. |
-V, --version | Print version. |
The week starts on Saturday (Sa Su Mo Tu We Th Fr), and today is highlighted
in reverse video. For the exact, always-current option list see the
CLI reference.