این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «توضیح کرون پنج‌فیلدی آنلاین»

این ابزار یک عبارت cron (مثلاً "0 9 * * 1-5") را تجزیه می‌کند و به انگلیسی ساده توضیح می‌دهد چه معنی دارد و کی شلیک می‌کند. چندین زمان اجرای بعدی را نشان می‌دهد تا بتوانید قبل از استقرار، تأیید کنید که زمان‌بندی با هدف شما مطابقت دارد.

Cron زبان زمان‌بندی استاندارد در سیستم‌های شبه‌Unix است، که در cron job، Kubernetes CronJobs، GitHub Actions، AWS EventBridge، و بسیاری از سیستم‌های دیگر استفاده می‌شود. نحو پنج فیلدی (دقیقه، ساعت، روز ماه، ماه، روز هفته) مختصر است اما اشتباه کردن آن آسان است.

قبل از commit زمان‌بندی‌ها در تولید از آن استفاده کنید. عبارتی که اشتباه خوانده شود و هر دقیقه به جای هر ساعت شلیک کند می‌تواند به سرعت قبض‌ها را افزایش دهد یا میلیون‌ها ایمیل اسپم تولید کند.

چطور از این ابزار استفاده کنم؟

چطور یک عبارت cron را به انگلیسی ساده توضیح دهم؟

  1. عبارت cron را بچسبانید

    «Cron expression» سینتکس کلاسیک پنج‌فیلدی Unix می‌خواهد: `minute hour day-of-month month day-of-week`. مثال: `0 9 * * 1` یعنی ۰۹:۰۰ هر دوشنبه.

  2. آنچه پشتیبانی می‌شود

    wildcardهای استاندارد (`*`)، listها (`1,15`)، رنج‌ها (`9-17`)، step‌ها (`*/15`، `0-30/5`) و نام‌های روز/ماه در جایی که پیاده‌سازی cron محلی می‌پذیرد. حداکثر ۱۲۰ نویسه.

  3. «اجرا» را بزنید

    خروجی یک توضیح قابل خواندن انسان از هر فیلد می‌دهد — مثل «At 09:00, on Mondays.». ابزار زمان‌های اجرای بعدی را محاسبه نمی‌کند؛ برای آن از cron-next-runs-online استفاده کنید.

  4. هشدارهای ۶-فیلدی و dialect

    Quartz / dialectهای غیراستاندارد با فیلد seconds یا year، ماکروهای پیش‌تعریف‌شده (`@hourly`، `@yearly`) یا پسوندهای `L`/`W`/`#` همگی هندل نمی‌شوند — explainer حول cron ۵-فیلدی POSIX-ish ساخته شده است.