com.cronutils.model.time

Class CompositeExecutionTime

java.lang.Object

com.cronutils.model.time.CompositeExecutionTime

All Implemented Interfaces:

ExecutionTime

public class CompositeExecutionTime
extends Object
implements ExecutionTime

Constructor Summary

Constructors

Constructor and Description
CompositeExecutionTime(List<ExecutionTime> executionTimes)

Method Summary

Modifier and Type	Method and Description
boolean	isMatch(java.time.ZonedDateTime date) Provide feedback if a given date matches the cron expression.
Optional<java.time.ZonedDateTime>	lastExecution(java.time.ZonedDateTime date) Provide nearest date for last execution.
Optional<java.time.ZonedDateTime>	nextExecution(java.time.ZonedDateTime date) Provide nearest date for next execution.
Optional<java.time.Duration>	timeFromLastExecution(java.time.ZonedDateTime date) Provide nearest time from last execution.
Optional<java.time.Duration>	timeToNextExecution(java.time.ZonedDateTime date) Provide nearest time for next execution.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.cronutils.model.time.ExecutionTime

countExecutions, forCron, getExecutionDates

Constructor Detail

CompositeExecutionTime

public CompositeExecutionTime(List<ExecutionTime> executionTimes)

Method Detail

nextExecution

public Optional<java.time.ZonedDateTime> nextExecution(java.time.ZonedDateTime date)

Description copied from interface: ExecutionTime

Provide nearest date for next execution.

Specified by:

nextExecution in interface ExecutionTime

Parameters:

date - - ZonedDateTime instance. If null, a NullPointerException will be raised.

Returns:

Optional ZonedDateTime instance, never null. Contains next execution time or empty.

timeToNextExecution

public Optional<java.time.Duration> timeToNextExecution(java.time.ZonedDateTime date)

Description copied from interface: ExecutionTime

Provide nearest time for next execution. Due to the question #468 we clarify: crons execute on local instance time. See: https://serverfault.com/questions/791713/what-time-zone-is-a-cron-job-using We ask for a ZonedDateTime for two reasons: (i) to provide flexibility on which timezone the cron is being executed (ii) to be able to reproduce issues regardless of our own local time (e.g.: daylight savings, etc.)

Specified by:

timeToNextExecution in interface ExecutionTime

Parameters:

date - - ZonedDateTime instance. If null, a NullPointerException will be raised.

Returns:

Duration instance, never null. Time to next execution.

lastExecution

public Optional<java.time.ZonedDateTime> lastExecution(java.time.ZonedDateTime date)

Description copied from interface: ExecutionTime

Provide nearest date for last execution. Due to the question #468 we clarify: crons execute on local instance time. See: https://serverfault.com/questions/791713/what-time-zone-is-a-cron-job-using We ask for a ZonedDateTime for two reasons: (i) to provide flexibility on which timezone the cron is being executed (ii) to be able to reproduce issues regardless of our own local time (e.g.: daylight savings, etc.)

Specified by:

lastExecution in interface ExecutionTime

Parameters:

date - - ZonedDateTime instance. If null, a NullPointerException will be raised.

Returns:

Optional ZonedDateTime instance, never null. Last execution time or empty.

timeFromLastExecution

public Optional<java.time.Duration> timeFromLastExecution(java.time.ZonedDateTime date)

Description copied from interface: ExecutionTime

Provide nearest time from last execution.

Specified by:

timeFromLastExecution in interface ExecutionTime

Parameters:

date - - ZonedDateTime instance. If null, a NullPointerException will be raised.

Returns:

Duration instance, never null. Time from last execution.

isMatch

public boolean isMatch(java.time.ZonedDateTime date)

Description copied from interface: ExecutionTime

Provide feedback if a given date matches the cron expression.

Specified by:

isMatch in interface ExecutionTime

Parameters:

date - - ZonedDateTime instance. If null, a NullPointerException will be raised.

Returns:

true if date matches cron expression requirements, false otherwise.