Activadores de eventos programados recurrentes

Tres activadores diferentes te permiten programar una automatización con anticipación:

1. Time.ScheduledTimeEvent
2. Time.RecurringClockTimeScheduledEvent
3. Time.RecurringSolarTimeScheduledEvent

El primero, Time.ScheduledTimeEvent, te permite programar una automatización para que comience en un instante preciso en el futuro o de forma recurrente, según la hora o un evento solar (es decir, el amanecer o el atardecer).

Por ejemplo, este activador inicia la automatización a las 10:00 p.m. todos los días:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(Time.ScheduledTimeEvent.clockTime(LocalTime.of(22, 0, 0, 0)))
}

Como alternativa, puedes especificar un evento de hora solar en lugar de la hora. El parámetro para este tipo de activador es un SolarTimeStruct que consta de lo siguiente:

1. type, que es SolarTimeType.Sunrise o SolarTimeType.Sunset.
2. offset, que te permite cambiar la hora de inicio en relación con el evento solar en cualquier período. Los valores positivos introducen una demora después del evento solar, y los valores negativos hacen que el activador se active antes del evento solar.

En el siguiente ejemplo, se muestra un activador que inicia la automatización 15 minutos antes del amanecer todos los días:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(
    Time.ScheduledTimeEvent.solarTime(
      SolarTimeStruct(SolarTimeType.Sunrise, java.time.Duration.ofMinutes(-15))
    )
  )
}

Los otros dos activadores son activadores de eventos programados recurrentes, que te permiten crear automatizaciones que se ejecutan periódicamente según criterios más específicos que pueden incluir condiciones basadas en el tiempo y el calendario.

Time.RecurringClockTimeScheduledEvent te permite programar una automatización en función de una o más condiciones de hora o fecha. Este activador usa una sintaxis similar a la que usa la utilidad cron de Unix para especificar la programación de una automatización recurrente.

Time.RecurringSolarTimeScheduledEvent te permite programar una automatización en función de la hora del amanecer o del atardecer, de manera opcional en combinación con una condición basada en el calendario.

Expresiones cron

Es posible que ya conozcas cron, un comando que se usa en sistemas Unix y Linux para programar trabajos recurrentes.

Los activadores de eventos programados recurrentes usan una sintaxis de expresión de programación similar a la que usa cron, por lo que las expresiones de programación que se usan con estos activadores se conocen como expresiones cron.

Existen varias "variantes" de cron y varias variaciones de sintaxis en estas implementaciones. Las expresiones cron del activador de eventos programados recurrentes usan la misma sintaxis que el programador de Quartz. La sintaxis de la expresión cron de Quartz se explica en la documentación de Quartz's CronExpression.

Ejemplos

A continuación, se muestran algunos ejemplos para ilustrarlo.

RecurringClockTimeScheduledEvent

En un activador RecurringClockTimeScheduledEvent, la cadena de expresión cron se asigna al Time.RecurringClockTimeScheduledEvent.cronExpression campo.

El siguiente es un ejemplo de un activador RecurringClockTimeScheduledEvent que inicia la automatización a las 8:00 p.m. todos los miércoles de abril:

starter<_>(structure, event = Time.RecurringClockTimeScheduledEvent) {
  parameter(Time.RecurringClockTimeScheduledEvent.cronExpression("0 0 20 ? 4 4 *"))
}

RecurringSolarTimeScheduleEvent

El activador RecurringSolarTimeScheduleEvent toma dos parámetros:

1. Un SolarTimeStruct.
2. cronExpression: Un subconjunto de una expresión cron que consta solo de los campos Día del mes, Mes, Día de la semana y Año. La hora solar determina la hora exacta en que comenzará la automatización, por lo que se omiten los campos Segundo, Minuto y Hora.

En el siguiente ejemplo, se muestra un activador que hace que una automatización comience una hora después del amanecer, todos los miércoles de abril:

starter<_>(structure, event = Time.RecurringSolarTimeScheduledEvent) {
  parameter(
    Time.RecurringSolarTimeScheduledEvent.solarTime(
      TimeTrait.SolarTimeStruct(SolarTimeType.Sunrise, Duration.ofHours(1))
    )
  )
  parameter(Time.RecurringSolarTimeScheduledEvent.cronExpression("? 4 4 *"))
}