phppkg/hucron

Express crontabs as human readable phrases

1.0.0 2021-09-28 02:00 UTC

This package is auto-updated.

Last update: 2024-10-09 21:29:18 UTC


README

GitHub tag (latest SemVer) Github Actions Status Php Version License

HuCron turns human readable strings about time and turns them into valid crontabs.

phppkg/hucron is 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, monday etc)
  • 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

LICENSE

MIT