com.cronutils.model.time

Class SingleExecutionTime

java.lang.Object

com.cronutils.model.time.SingleExecutionTime

All Implemented Interfaces:

ExecutionTime

public class SingleExecutionTime
extends Object
implements ExecutionTime

Calculates execution time given a cron pattern.

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

forCron

Method Detail

nextExecution

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

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)

Provide nearest time for next execution.

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)

Provide nearest date for last execution.

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)

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)

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.