HuCron
HuCron turns human readable strings about time and turns them into valid crontabs.
phppkg/hucronis froked from the https://github.com/ajbdev/cronlingo
Install
composer install phppkg/hucron
Usage
There are some examples for parse human statement.
Shortcuts statement
use HuCron\HuCron;
echo HuCron::fromStatement('@hourly'); // "0 * * * *"
echo HuCron::fromStatement('@daliy'); // "0 0 * * *"
echo HuCron::fromStatement('@weekly'); // "0 0 * * 0"
echo HuCron::fromStatement('@monthly'); // "0 0 1 * *"
// echo HuCron::fromStatement('@yearly');
echo HuCron::fromStatement('@annually'); // "0 0 1 1 *"
Custom statement
use HuCron\HuCron;
echo HuCron::fromStatement('Every day at midnight');
// "0 0 * * *"
echo HuCron::fromStatement('Every 15 minutes at midnight on the weekend');
// "*/15 0 * * 0,6"
echo HuCron::fromStatement('Every other minute in August at noon on a weekday');
// "*/2 12 * 8 1,2,3,4,5"
echo HuCron::fromStatement('The 1st day in April at midnight');
// "0 0 1 4 *"
echo HuCron::fromStatement('Every day on the weekday at 2:25pm');
// "25 14 * * 1,2,3,4,5"
Syntax
HuCron identifies the parts of a string with specific time-related keywords such as "on, to, at" and uses this to deduce the time meaning and convert it into part of a cron tab. It's not particular about the order of these statements. Here's a brief list of things that it will pick up and parse into a crontab:
- Periods (
daily, weekly, monthly) - Exact times (
9:30 PM, 8a, 3p) - Meridiems (
AM/PM/A/P) - Intervals (
1st, second, other, ninth, etc) - Specific fields (
second, minute, hour, day, month) - Day of week (
sunday, mondayetc) - 12 o'clocks (
noon, midnight) - Lists (e.g.
5 to 12 minutes) - Month names (
january, february, etc) - Weekend / weekday
What's a cron tab?
A cron tab is an expression that defines a recurring period of time.
It looks something like this:
* * * * *
- - - - -
| | | | |
| | | | +----- day of week (0 - 7) (Sunday=0 or 7)
| | | +---------- month (1 - 12)
| | +--------------- day of month (1 - 31)
| +-------------------- hour (0 - 23)
+------------------------- min (0 - 59)
From Wikipedia:
The software utility Cron is a time-based job scheduler in Unix-like computer operating systems. People who set up and maintain software environments use cron to schedule jobs (commands or shell scripts) to run periodically at fixed times, dates, or intervals. It typically automates system maintenance or administration—though its general-purpose nature makes it useful for things like connecting to the Internet and downloading email at regular intervals.
Related
- https://github.com/dragonmantank/cron-expression Calculate the next or previous run date and determine
- https://github.com/lorisleiva/cron-translator Makes CRON expressions human-readable
7 Oct 19, 2022
1.2k Jan 3, 2023
10.3k Jan 1, 2023
452 Jan 4, 2023
21 Dec 21, 2022
3 Nov 9, 2021
1 Dec 3, 2021
25 Jul 17, 2022
52 Dec 12, 2022
1 Jan 9, 2022
447 Dec 27, 2022
907 Dec 30, 2022
3.5k Jan 6, 2023
63 Nov 13, 2022
2 Jun 19, 2022
2.1k Jan 8, 2023
1.6k Dec 23, 2022
1 Dec 3, 2021
149 Dec 30, 2022
996 Dec 28, 2022
5 Aug 19, 2022
36 Dec 28, 2022
4 Oct 20, 2022
3 Oct 26, 2021
72 Dec 23, 2022
5 Oct 19, 2022
4 Feb 22, 2022