Examples

Live, colored versions of these run on pcal.nl. Below is the plain text each command prints.

Current month

$ pcal
      Tir 2585
Sa Su Mo Tu We Th Fr
       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

(The current day is highlighted in reverse video.)

Three months side by side

$ pcal -3

Shows the previous, current, and next month in a row — handy for planning across a month boundary.

A full year

$ pcal -y 2585

Prints all twelve months of 2585 in a three-column grid.

A specific month

$ pcal mordad 2585     # or: pcal 5 2585
     Mordad 2585
Sa Su Mo Tu We Th Fr
            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

Day-of-year numbering

$ pcal -j 1 2585

Replaces each day-of-month with its ordinal day-of-year (1–365/366).

Persian script

$ pcal --persian 1 2585
     فروردین ۲۵۸۵
 ش  ی  د  س  چ  پ  ج
                   ۱
 ۲  ۳  ۴  ۵  ۶  ۷  ۸
 ۹ ۱۰ ۱۱ ۱۲ ۱۳ ۱۴ ۱۵
۱۶ ۱۷ ۱۸ ۱۹ ۲۰ ۲۱ ۲۲
۲۳ ۲۴ ۲۵ ۲۶ ۲۷ ۲۸ ۲۹
۳۰ ۳۱

Month and weekday names and digits switch to Persian, while the grid stays left-to-right.