waybar-clock(5) User Manual waybar-clock(5) نام (NAME) waybar-clock - ماژول ساعت در waybar توضیحات (DESCRIPTION) ماژول clock تاریخ و زمان کنونی را نمایش می‌دهد. فایل‌ها (FILES) $XDG_CONFIG_HOME/waybar/config فایل پیکربندی اختصاصی هر کاربر پیکربندی (CONFIGURATION) 1. آدرس‌دهی شده با clock ┌───────────────────────────┬─────────────────┬──────────────────┬────────────────────────────────────────────────────────────────┐ │ گزینه (Option) │ نوع (Typeof) │ پیش‌فرض (Default) │ توضیحات (Description) │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │interval │ integer │ 60 │ بازهٔ زمانی (بر حسب ثانیه) برای دریافت و به‌روزرسانی اطلاعات. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │format │ string │ {:%H:%M} │ قالب نحوهٔ نمایش تاریخ و زمان. گزینه‌های قالب‌بندی را در زیر │ │ │ │ │ مشاهده کنید. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │timezone │ string │ │ منطقهٔ زمانی برای نمایش زمان؛ برای نمونه America/New_York. │ │ │ │ │ مقدار "" بیانگر منطقهٔ زمانی محلی سامانه است. فهرست غیررسمی │ │ │ │ │ مناطق زمانی در ویکی‌پدیا را ببینید: │ │ │ │ │ │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │timezones │ list of strings │ │ فهرستی از مناطق زمانی (مشابه timezone) برای استفاده در نمایش │ │ │ │ │ زمان، که با چرخ اسکرول ماوس جابه‌جا می‌شوند. هنگام تعیین گزینهٔ │ │ │ │ │ timezones، گزینهٔ timezone را مشخص نکنید. مقدار "" بیانگر منطقهٔ │ │ │ │ │ زمانی محلی سامانه است. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │timezone-tooltip-format │ string │ │ قالب مورد استفاده برای نمایش مناطق زمانی در راهنمای شناور │ │ │ │ │ (tooltip). در صورت تنظیم، امکان نمایش اطلاعات منطقهٔ زمانی │ │ │ │ │ (مانند اختصارات منطقهٔ زمانی) را در راهنمای شناور فراهم می‌کند │ │ │ │ │ در حالی که نمایشگر اصلی خلوت می‌ماند. از همان گزینه‌های قالب‌بندی │ │ │ │ │ format استفاده می‌کند. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │locale │ string │ │ مکان‌تنظیم (locale) برای نمایش زمان. برای رندر زمان در مناطق │ │ │ │ │ زمانی سفارشی با زبان و قالب مناسب به کار می‌رود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │max-length │ integer │ │ بیشینهٔ طول (بر حسب نویسه) که پودمان باید نمایش دهد. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │rotate │ integer │ │ مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه). │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │on-click │ string │ │ دستوری که هنگام کلیک بر روی پودمان اجرا می‌شود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │on-click-middle │ string │ │ دستوری که هنگام کلیک وسط (با چرخ ماوس) بر روی پودمان اجرا │ │ │ │ │ می‌شود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │on-click-right │ string │ │ دستوری که هنگام کلیک راست بر روی پودمان اجرا می‌شود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │on-scroll-up │ string │ │ دستوری که هنگام اسکرول به بالا بر روی پودمان اجرا می‌شود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │on-scroll-down │ string │ │ دستوری که هنگام اسکرول به پایین بر روی پودمان اجرا می‌شود. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │smooth-scrolling-threshold │ double │ │ آستانهٔ مورد استفاده هنگام اسکرول روان. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │tooltip │ bool │ true │ گزینه‌ای برای فعال‌سازی راهنمای شناور (tooltip) هنگام نگه داشتن │ │ │ │ │ نشانگر ماوس. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │tooltip-format │ string │ مشابه format │ راهنمای شناور هنگام نگه داشتن نشانگر ماوس. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │menu │ string │ │ اقدامی که منو را باز می‌کند. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │menu-file │ string │ │ مسیر فایل توصیف‌گر منو. باید عنصری از نوع GtkMenu با شناسهٔ menu │ │ │ │ │ وجود داشته باشد. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │menu-actions │ array │ │ اقدامات متناظر با دکمه‌های منو. │ ├───────────────────────────┼─────────────────┼──────────────────┼────────────────────────────────────────────────────────────────┤ │expand: │ bool │ false │ به این پودمان امکان می‌دهد تمام فضای باقی‌مانده را به‌صورت پویا │ │ │ │ │ مصرف کند. │ └───────────────────────────┴─────────────────┴──────────────────┴────────────────────────────────────────────────────────────────┘ تمامی گزینه‌های معتبر قالب‌بندی را در strftime(3) مشاهده کنید یا به نشانی https://en.cppreference.com/w/cpp/chrono/duration/formatter مراجعه فرمایید. 2. آدرس‌دهی شده با clock: calendar ┌───────────────┬──────────────┬──────────────────┬──────────────────┐ │گزینه (Option) │ نوع (Typeof) │ پیش‌فرض (Default) │ توضیحات │ │ │ │ │ (Description) │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │mode │ string │ month │ حالت نمایش │ │ │ │ │ تقویم. مقادیر │ │ │ │ │ ممکن: year|month │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │mode-mon-col │ integer │ 3 │ مرتبط با │ │ │ │ │ mode=year. تعداد │ │ │ │ │ ماه‌ها در هر سطر. │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │weeks-pos │ string │ │ موقعیتی که │ │ │ │ │ شماره‌های هفته │ │ │ │ │ باید نمایش داده │ │ │ │ │ شوند. هنگام خالی │ │ │ │ │ بودن غیرفعال │ │ │ │ │ است. مقادیر │ │ │ │ │ ممکن: left|right │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │on-scroll │ integer │ 1 │ مقدار اسکرول │ │ │ │ │ ماه‌ها/سال‌ها به │ │ │ │ │ جلو/عقب. می‌تواند │ │ │ │ │ منفی باشد. تحت │ │ │ │ │ گزینهٔ on-scroll │ │ │ │ │ پیکربندی می‌شود. │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │iso8601 │ bool │ false │ هنگام فعال بودن، │ │ │ │ │ تقویم از │ │ │ │ │ استاندارد ISO │ │ │ │ │ 8601 پیروی │ │ │ │ │ می‌کند: هفته‌ها از │ │ │ │ │ دوشنبه آغاز │ │ │ │ │ می‌شوند و نخستین │ │ │ │ │ هفتهٔ سال با │ │ │ │ │ شمارهٔ ۱ │ │ │ │ │ شماره‌گذاری │ │ │ │ │ می‌شود. قالب │ │ │ │ │ پیش‌فرض هفته │ │ │ │ │ '{:%V}' است. │ └───────────────┴──────────────┴──────────────────┴──────────────────┘ 3. آدرس‌دهی شده با clock: calendar: format ┌───────────────┬──────────────┬──────────────────┬──────────────────┐ │گزینه (Option) │ نوع (Typeof) │ پیش‌فرض (Default) │ توضیحات │ │ │ │ │ (Description) │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │months │ string │ │ قالب اعمال‌شده بر │ │ │ │ │ سرآیند ماه‌ها │ │ │ │ │ (January، │ │ │ │ │ February و │ │ │ │ │ غیره). │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │days │ string │ │ قالب اعمال‌شده بر │ │ │ │ │ روزها. │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │weeks │ string │ {:%U} │ قالب اعمال‌شده بر │ │ │ │ │ شماره‌های هفته. │ │ │ │ │ هنگامی که قالب │ │ │ │ │ روزهای هفته │ │ │ │ │ ارائه نشده باشد، │ │ │ │ │ از قالب پیش‌فرض │ │ │ │ │ استفاده می‌شود: │ │ │ │ │ در صورتی که هفته │ │ │ │ │ با دوشنبه آغاز │ │ │ │ │ شود '{:%W}' و در │ │ │ │ │ غیر این صورت │ │ │ │ │ '{:%U}'. │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │weekdays │ string │ │ قالب اعمال‌شده بر │ │ │ │ │ سرآیند روزهای │ │ │ │ │ هفته (Su، Mo و │ │ │ │ │ غیره). │ ├───────────────┼──────────────┼──────────────────┼──────────────────┤ │today │ string │ {} │ قالب اعمال‌شده بر │ │ │ │ │ روز جاری │ │ │ │ │ (امروز). │ └───────────────┴──────────────┴──────────────────┴──────────────────┘ اقدامات (ACTIONS) ┌──────────────┬──────────────────────────┐ │رشته (String) │ اقدام (Action) │ ├──────────────┼──────────────────────────┤ │mode │ تغییر حالت تقویم بین │ │ │ سال/ماه (year/month) │ ├──────────────┼──────────────────────────┤ │tz_up │ تغییر به منطقهٔ زمانی │ │ │ مشخص‌شدهٔ بعدی │ ├──────────────┼──────────────────────────┤ │tz_down │ تغییر به منطقهٔ زمانی │ │ │ مشخص‌شدهٔ قبلی │ ├──────────────┼──────────────────────────┤ │shift_up │ انتقال به ماه/سال تقویمی │ │ │ بعدی │ ├──────────────┼──────────────────────────┤ │shift_down │ انتقال به ماه/سال تقویمی │ │ │ قبلی │ └──────────────┴──────────────────────────┘ جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS) • {calendar}: تقویم ماه کنونی • {tz_list}: فهرست زمان در سایر مناطق زمانی، در صورتی که بیش از یک منطقهٔ زمانی در پیکربندی تنظیم شده باشد • {ordinal_date}: روز جاری در شکل ترتیبی (انگلیسی)، مانند 21st مثال‌ها (EXAMPLES) 1. عمومی (General) "clock": { "interval": 60, "format": "{:%H:%M}", "max-length": 25 } 2. تقویم (Calendar) "clock": { "format": "{:%H:%M}  ", "format-alt": "{:%A, %B %d, %Y (%R)}  ", "tooltip-format": "{calendar}", "calendar": { "mode" : "year", "mode-mon-col" : 3, "weeks-pos" : "right", "on-scroll" : 1, "on-click-right": "mode", "format": { "months": "{}", "days": "{}", "weeks": "W{}", "weekdays": "{}", "today": "{}" } }, "actions": { "on-click-right": "mode", "on-click-forward": "tz_up", "on-click-backward": "tz_down", "on-scroll-up": "shift_up", "on-scroll-down": "shift_down" } }, 3. نمایش تاریخ کامل هنگام نگه داشتن نشانگر ماوس (Full date on hover) "clock": { "interval": 60, "tooltip": true, "format": "{:%H.%M}", "tooltip-format": "{:%Y-%m-%d}", } 4. نمایش منطقهٔ زمانی فقط در راهنمای شناور (Show timezone in tooltip only) "clock": { "interval": 60, "format": "{:%H:%M}", "timezone-tooltip-format": "{:%H:%M %Z}", "timezones": [ "", "America/Chicago", "America/Los_Angeles", "Europe/Paris", "UTC" ], "tooltip": true, "tooltip-format": "{tz_list}" } استایل (STYLE) • #clock عیب‌یابی (TROUBLESHOOTING) اگر پودمان clock در زمان راه‌اندازی با پیام خطای locale::facet::_S_create_c_locale name not valid غیرفعال شد، یکی از موارد زیر را امتحان کنید: • بررسی کنید که متغیر LC_TIME به‌درستی تنظیم شده باشد (glibc) • تنظیم locale به C در فایل پیکربندی (musl) گزینهٔ locale باید تنظیم شود تا {calendar} بدون توجه به مکان‌تنظیم سامانه، از شروع هفتهٔ صحیح استفاده کند. تقویم به زبان چینی. تراز (Calendar in Chinese. Alignment) به منظور داشتن یک تقویم چینی تراز شده، توصیه‌های مفیدی وجود دارد: 1. از قلم "WenQuanYi Zen Hei Mono" استفاده کنید که در اکثر توزیع‌های لینوکس ارائه شده است. 2. اندازه‌های مختلف قلم را آزمایش کنید و بهترین را برای خود بیابید؛ اندازهٔ size = 9pt مناسب خواهد بود. 3. در صورتی که از قلم "WenQuanYi Zen Hei Mono" استفاده می‌شود، تگ pango مربوط به قلم مونو‌اسپیس (monospace) را غیرفعال کنید. نمونه‌ای از پیکربندی کارآمد "clock": { "format": "{:%H:%M}  ", "format-alt": "{:%A, %B %d, %Y (%R)}  ", "tooltip-format": "n{calendar}", "calendar": { "mode" : "year", "mode-mon-col" : 3, "weeks-pos" : "right", "on-scroll" : 1, "on-click-right": "mode", "format": { "months": "{}", "days": "{}", "weeks": "W{}", "weekdays": "{}", "today": "{}" } }, "actions": { "on-click-right": "mode", "on-click-forward": "tz_up", "on-click-backward": "tz_down", "on-scroll-up": "shift_up", "on-scroll-down": "shift_down" } }, نویسنده (AUTHOR) Alexis Rouillard waybar-clock 2026-08-31 waybar-clock(5)