Table of Contents

Class CronScheduleOptions

Namespace
Excalibur.Dispatch.Options.Scheduling
Assembly
Excalibur.Dispatch.dll

Configuration options for cron-based scheduling.

public sealed class CronScheduleOptions
Inheritance
CronScheduleOptions
Inherited Members
Extension Methods

Properties

AutoAdjustForDaylightSaving

Gets or sets a value indicating whether the explicit HandleDaylightSavingTransition(DateTimeOffset, TimeZoneInfo) helper adjusts invalid and ambiguous local times. Parsed cron expressions use Cronos transition handling independently of this setting.

public bool AutoAdjustForDaylightSaving { get; set; }

Property Value

bool

The current AutoAdjustForDaylightSaving value.

DefaultTimeZone

Gets or sets the default timezone to use when none is specified. Defaults to UTC.

public TimeZoneInfo DefaultTimeZone { get; set; }

Property Value

TimeZoneInfo

The current DefaultTimeZone value.

EnableDetailedLogging

Gets or sets a value indicating whether to log detailed cron evaluation information.

public bool EnableDetailedLogging { get; set; }

Property Value

bool

The current EnableDetailedLogging value.

EnableExtendedSyntax

Gets or sets a value indicating whether to enable extended cron syntax features. This includes special characters like L (last), W (weekday), # (nth occurrence). When false, expressions using these operators are rejected at parse time.

public bool EnableExtendedSyntax { get; set; }

Property Value

bool

The current EnableExtendedSyntax value.

ExecutionToleranceWindow

Gets or sets the tolerance window for execution timing. Jobs scheduled within this window of their target time are considered on-time.

public TimeSpan ExecutionToleranceWindow { get; set; }

Property Value

TimeSpan

The tolerance window for execution timing. Jobs scheduled within this window of their target time are considered on-time.

IncludeSeconds

Gets or sets a value indicating whether to include seconds in cron expressions by default. When true, expects 6-field format (seconds minutes hours day month weekday). When false, expects 5-field format (minutes hours day month weekday). Defaults to false.

public bool IncludeSeconds { get; set; }

Property Value

bool

The current IncludeSeconds value.

MaxMissedExecutions

Gets or sets the maximum number of missed executions to catch up on. Only applies when MissedExecutionBehavior is ExecuteAllMissed.

public int MaxMissedExecutions { get; set; }

Property Value

int

The current MaxMissedExecutions value.

MissedExecutionBehavior

Gets or sets how to handle missed executions (e.g., due to system downtime).

public MissedExecutionBehavior MissedExecutionBehavior { get; set; }

Property Value

MissedExecutionBehavior

The current MissedExecutionBehavior value.

SupportedTimeZoneIds

Gets the supported timezones for scheduling. If empty, all system timezones are supported.

public HashSet<string> SupportedTimeZoneIds { get; }

Property Value

HashSet<string>

The current SupportedTimeZoneIds value.