mycron(5)

NAME
mycron - special crontab syntax explaination

DESCRIPTION
mycrons crontab syntax differs from the usual crontab syntax a lot. Of course you have the date/time part and the command, but the definitions are ISO 8601 valid using a dot (.) as wildcard character.

LOCATION
The crontab has to be stored at ${HOME}/.config/mycron/mycron.crontab for mycron to recognize it. Use mycron -e for creating and editing it in the correct location.

SYNTAX

Date/Time format
    ISO 8601 specifies day/time notation with time zone. Because mycron is only exact to the minute, seconds and time zone are omitted. Set the date with YYYY-MM-DDTHH:MM where YYYY is the year, MM is the month, DD is the day, HH is the hour in 24h format and MM is the minute. For every single digit you can input a . (a single colon) as wildcard.

Day of the week
    ISO 8601 specifies Monday as first day of the week and Sunday as last day of the week, therefore Monday is 1, Thursday is 2, ..., Sunday is 7. If you use . (a single colon), mycron interprets it as "every day".

Command
    The last of the three blocks is the command block. Here you can use whatever you want. Please desist from using non-ASCII characters like German umlauts, other special symbols, etc. It will not break mycron or it's validity check, but fails on mycron actually executed by your cron daemon.

Comments
    Comments are indicated by using # in the beginning of a line. It might work in most cases but you should not rely on comments after some actual crontab entries. (End-of-line comments)

EXAMPLES

....-..-..T..:.. . command
    This line executes the command every minute at every day.

....-..-..T18:57 7 command
    Here the command gets executed every Sunday at 18:57 o'clock.

....-..-..T07:38 1267 command
    When given multiple digits for the day, the command gets executed on all of the days. Here on Mondays, Tuesdays, Saturdays and Sundays at 07:38 o'clock.

2013-05-..T..:00 4 command
    This very specific line results in execution of the given command on every full hour at every Friday in May 2013.

....-12-..T14:.. . command
    The command will be executed every minute from 14:00 to 14:59 o'clock on everyday in every December.

2018-01-14T10:45 2 command
    Because 2018-01-14 is a Sunday (7) this command will never be executed :)

FILES

Vim syntax file
    /usr/share/doc/mycron/crontab.vim

AUTHOR
Dirk Sohler, <spam@0x7be.de>

SEE ALSO
mycron(1), mycron.conf(5)