Timegenerators

A “timegenerator” is something that describe _when_ you want to do something.

Kinds of timegenerators

There are 3 kinds of timegenerators in larigira:

single

With single, you just set a single time the event should happen.

frequency

Sometimes you have something happening very regularly. For example you might want a jingle every 30minutes, or a specific show every friday at 8PM.

cron

Sometimes your specification is very complex.

For example, you might want a specific message to be sent at 10:00, 13:00, 15:00 and 18:00, but only during working days. That would be hard to do with a single frequency event, so you could use a cron

0 10,13,15,18 * * 1-5

I know, that’s very difficult, but is still a possibility you have. If you want to learn how to write crons, check this helpful site.

Exclusions

Exclusions are a way to have your timegenerator “skip” specific moments, or intervals, or what not. For example, you might want to have something run every Monday, but specifically not Monday 2024-08-26.

Exclusions are supported by every timegenerator.

You can set them by adding lines to the “exclude” field, which every timegenerator has. It’s a textarea, and every line you add can be in one of these formats:

• YYYY-MM-DD. A whole day is skipped

• YYYY-MM-DDTHH:MM:SS A specific occurrence is skipped

• cron-style (see above for details on the syntax), so you can exclude using the cron syntax, which is more powerful, especially when you have periodicity