How to use the command jcal (with examples)
The jcal command is used to display calendar information in the Jalali format, with the current day highlighted. It is a helpful tool for viewing and navigating through calendars in the Jalali format.
Use case 1: Display a calendar for the current month
Code:
jcal
Motivation: By using the jcal command without any arguments, you can quickly view the calendar for the current month. This is useful for referencing days and dates, planning events, or simply staying organized.
Explanation: The command jcal without any parameters displays the calendar for the current month. It uses the default settings to determine the current month and year.
Example output:
آذر ۱۳۹۹
ش ی د س چ پ ج
+-----------------------+
۱
۲ ۳ ۴ ۵ ۶ ۷ ۸
۹ ۱۰ ۱۱ ۱۲ ۱۳ ۱۴ ۱۵
۱۶ ۱۷ ۱۸ ۱۹ ۲۰ ۲۱ ۲۲
۲۳ ۲۴ ۲۵ ۲۶ ۲۷ ۲۸ ۲۹
۳۰
The output displays the calendar for the current month, highlighting the current day (in this case, the first day of the month). The month and year are also displayed at the top.
Use case 2: Display the previous, current, and next months
Code:
jcal -3
Motivation: In some cases, it may be useful to see the previous and next months along with the current month. This can help provide context and make it easier to track events or plan activities across multiple months.
Explanation: The -3 option passed to the jcal command instructs it to display not just the current month, but also the previous and next months. This helps create a more complete view of the calendar, spanning three months in total.
Example output:
آبان ۱۳۹۹ آذر ۱۳۹۹ دی ۱۳۹۹
ش ی د س چ پ ج ش ی د س چ پ ج ش ی د س چ پ ج
+-----------------------+-----------------------+-----------------------+
۱ ۱ ۲ ۳ ۴ ۵ ۶ ۷ ۸ ۱ ۲ ۳ ۴ ۵
۲ ۳ ۴ ۵ ۶ ۷ ۸ ... ۹ ۱۰ ۱۱ ۱۲ ۱۳ ۱۴ ۱۵ ... ۶ ۷ ۸ ۹ ۱۰
... ۹ ۱۰ ۱۱ ۱۲ ۱۳ ۱۴ ۱۵ ۱۶ ۱۷ ۱۸ ۱۹ ۲۰ ۲۱ ۱۱ ۱۲ ۱۳ ۱۴
... ۱۶ ۱۷ ۱۸ ۱۹ ۲۰ ۲۱ ۲۲ ۲۳ ۲۴ ۲۵ ۲۶ ۲۷ ۲۸ ... ۱۵ ۱۶ ۱۷ ۱۸
... ۲۳ ۲۴ ۲۵ ۲۶ ۲۷ ۲۸ ۲۹ ۲۹ ۳۰ ۳۱ ... ۱۹ ۲۰ ۲۱ ۲۲ ۲۳
... ۳۰ ۳۱ ... ۲۴ ۲۵ ۲۶
The output now displays three months: the previous month, the current month with the current day highlighted, and the next month. This expanded view makes it easier to see the flow of days and weeks across multiple months.
Use case 3: Display a calendar for a specific year (4 digits)
Code:
jcal year
Motivation: Sometimes, it is necessary to view the calendar for a specific year. This can be helpful for planning long-term events, tracking holidays, or simply exploring dates in the future or past.
Explanation: By passing a 4-digit year as an argument to the jcal command, you can view the calendar for that particular year. This allows you to navigate through specific years and explore the dates and days they contain.
Example output:
۱۳۹۹ ۱۴۰۰ ۱۴۰۱
فروردین اردیبهشت خرداد تیر مرداد شهریور
۳۰ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز
+------------------------+------------------------+-------------------------+
مهر آبان آذر دی بهمن
۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز
+------------------------+------------------------+-------------------------+
اسفند فروردین اردیبهشت خرداد تیر
۳۳ روز ۳۱ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز
+------------------------+------------------------+-------------------------+
مرداد شهریور مهر آبان آذر
۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز ۳۳ روز
+------------------------+------------------------+-------------------------+
دی بهمن اسفند
۳۳ روز ۳۳ روز ۳۳ روز
+------------------------+------------------------+
The output displays the calendar for the specified year. Each month is shown separately, along with the number of days it contains. This allows you to explore the days and dates of a specific year.
Use case 4: Display a calendar for a specific month and year
Code:
jcal year month
Motivation: In some cases, you may want to view the calendar for a specific month and year. This can be useful for planning events, keeping track of appointments, or simply exploring different months and years.
Explanation: By providing both a 4-digit year and a month number as arguments to the jcal command, you can view the calendar for that specific month and year. This allows you to focus on a particular month and navigate through its days and weeks.
Example output:
دی ۱۳۹۹
ش ی د س چ پ ج
+-----------------------+
۱
۲ ۳ ۴ ۵ ۶ ۷ ۸
۹ ۱۰ ۱۱ ۱۲ ۱۳ ۱۴ ۱۵
۱۶ ۱۷ ۱۸ ۱۹ ۲۰ ۲۱ ۲۲
۲۳ ۲۴ ۲۵ ۲۶ ۲۷ ۲۸ ۲۹
۳۰ ۳۱
The output displays the calendar for the specified month and year. This allows you to focus on that specific month and view its days and dates. The month and year are also displayed at the top.
Conclusion:
The jcal command provides a convenient way to view and navigate through calendars in the Jalali format. It offers various options to display calendars for different months and years, making it easier to plan events, track dates, and stay organized. Whether you need to view the current month, explore future or past months, or focus on specific months and years, the jcal command can help you achieve that.
