commands – job schedule (date)

Add/delete a date job schedule.

Date schedules, trigger a job once at the specified time and date.

Usage

job schedule (add|delete) name at hh:mm[:ss] dd/mm/yyyy
job schedule (add|delete) name at hh:mm[:ss] day

where

add	add the specified schedule.
delete	delete the specified schedule.
name	of job whose schedule to add/delete.
hh:mm[:ss]	time to trigger.
dd/mm/yyyy	date to trigger. If not defined, then the date will default to the date (today or tomorrow) when time next occurs after this command is executed.
day	to trigger, where day is one of mon[day], tue[sday], wed[nesday], thu[srday], fri[day], sat[urday], sun[day]. This is a shorthand method of defining the date that the job should trigger.

write on name

Examples

Schedule a job to run at 6pm today

BeyondCron % job schedule add /examples/quarter-moon at 18:00
BeyondCron % job show $$

----------- ---------------------- Name /examples/quarter-moon Description Quarter moon tonight ... Timezone Asia/Tokyo ... Schedules at 18:00:00 today ...

Delete a job schedule

BeyondCron % job schedule delete /examples/quarter-moon at 18:00
BeyondCron % job show $$

----------- ---------------------------- Name /examples/full-moon Description Full moon tonight ... Schedules ...

Schedule a job on a day within the next week

BeyondCron % job schedule add /examples/lunar-eclipse at 18:00 wednesday
BeyondCron % job show $$

----------- ---------------------------- Name /examples/lunar-eclipse Description Total lunar eclipse tonight ... Timezone Asia/Tokyo ... Schedules at 18:00:00 Wednesday ...

Schedule a job on a specific date

BeyondCron % job schedule add /examples/blue-moon at 18:00 20/8/2024
BeyondCron % job show $$

----------- ----------------------- Name /examples/blue-moon Description Full moon tonight ... Timezone Asia/Tokyo ... Schedules at 18:00:00 19/05/2019 at 18:00:00 22/08/2021 at 18:00:00 20/08/2024 ...