```
@Target(METHOD)
@Retention(RUNTIME)
@Repeatable(Schedules.class)
public @interface Scheduled
```
Identifies a method of a bean class that is automatically scheduled and invoked by the container.
A scheduled method is a non-abstract non-private method of a bean class. It may be either static or non-static.
The schedule is defined either by cron() or by every() attribute. If both are specified, the cron expression takes precedence.
```
 @ApplicationScoped
 class MyService {

     @Scheduled(cron = "0/5 * * * * ?")
     void check() {
         // do something important every 5 seconds
     }
 }
 
```
The annotated method must return void, java.util.concurrent.CompletionStage<Void> or io.smallrye.mutiny.Uni<Void> and either declare no parameters or one parameter of type ScheduledExecution.
By default, a scheduled method is executed on the main executor for blocking tasks. However, a scheduled method that returns java.util.concurrent.CompletionStage<Void> or io.smallrye.mutiny.Uni<Void>, or is annotated with NonBlocking is executed on the event loop.
See Also:

ScheduledExecution

Optional Element Summary

Optional Elements
Modifier and Type	Optional Element	Description
`Scheduled.ConcurrentExecution`	`concurrentExecution`	Specify the strategy to handle concurrent execution of a scheduled method.
`String`	`cron`	Defines a cron-like expression.
`long`	`delay`	Delays the time the trigger should start at.
`String`	`delayed`	Defines a period after which the trigger should start.
`TimeUnit`	`delayUnit`
`String`	`every`	Defines a period between invocations.
`String`	`identity`	Optionally defines a unique identifier for this job.
`String`	`overdueGracePeriod`	Defines a period after which the job is considered overdue.
`Class<? extends Scheduled.SkipPredicate>`	`skipExecutionIf`	Specify the bean class that can be used to skip any execution of a scheduled method.

- Element Detail
  - identity
```
String identity
```
    Optionally defines a unique identifier for this job.
    The value can be a property expression. In this case, the scheduler attempts to use the configured value instead: @Scheduled(identity = "${myJob.identity}"). Additionally, the property expression can specify a default value: @Scheduled(identity = "${myJob.identity:defaultIdentity}").
    If the value is not provided then a unique id is generated.
    
    Returns:
    
    the unique identity of the schedule
    
    Default:
    
    ""
- - cron
```
String cron
```
    Defines a cron-like expression. For example "0 15 10 * * ?" fires at 10:15am every day.
    The value can be a property expression. In this case, the scheduler attempts to use the configured value instead: @Scheduled(cron = "${myJob.cronExpression}"). Additionally, the property expression can specify a default value: @Scheduled(cron = "${myJob.cronExpression:0/2 * * * * ?}").
    Furthermore, two special constants can be used to disable the scheduled method: off and disabled. For example, @Scheduled(cron="${myJob.cronExpression:off}") means that if the property is undefined then the method is never executed.
    
    Returns:
    
    the cron-like expression
    
    Default:
    
    ""
- - every
```
String every
```
    Defines a period between invocations.
    The value is parsed with Duration.parse(CharSequence). However, if an expression starts with a digit, "PT" prefix is added automatically, so for example, 15m can be used instead of PT15M and is parsed as "15 minutes". Note that the absolute value of the value is always used.
    The value can be a property expression. In this case, the scheduler attempts to use the configured value instead: @Scheduled(every = "${myJob.everyExpression}"). Additionally, the property expression can specify a default value: @Scheduled(every = "${myJob.everyExpression:5m}").
    Furthermore, two special constants can be used to disable the scheduled method: off and disabled. For example, @Scheduled(every="${myJob.everyExpression:off}") means that if the property is undefined then the method is never executed.
    
    Returns:
    
    the period expression based on the ISO-8601 duration format PnDTnHnMn.nS
    
    Default:
    
    ""
- - delay
```
long delay
```
    Delays the time the trigger should start at. The value is rounded to full second.
    By default, the trigger starts when registered.
    
    Returns:
    
    the initial delay
    
    Default:
    
    0L
- - delayUnit
```
TimeUnit delayUnit
```
    Returns:
    
    the unit of initial delay
    
    See Also:
    
    delay()
    
    Default:
    
    java.util.concurrent.TimeUnit.MINUTES
- - delayed
```
String delayed
```
    Defines a period after which the trigger should start. It's an alternative to delay(). If delay() is set to a value greater than zero the value of delayed() is ignored.
    The value is parsed with Duration.parse(CharSequence). However, if an expression starts with a digit, "PT" prefix is added automatically, so for example, 15s can be used instead of PT15S and is parsed as "15 seconds". Note that the absolute value of the value is always used.
    The value can be a property expression. In this case, the scheduler attempts to use the configured value instead: @Scheduled(delayed = "${myJob.delayedExpression}"). Additionally, the property expression can specify a default value: @Scheduled(delayed = "${myJob.delayedExpression:5m}").
    
    Returns:
    
    the period expression based on the ISO-8601 duration format PnDTnHnMn.nS
    
    Default:
    
    ""
- - concurrentExecution
```
Scheduled.ConcurrentExecution concurrentExecution
```
    Specify the strategy to handle concurrent execution of a scheduled method. By default, a scheduled method can be executed concurrently.
    
    Returns:
    
    the concurrent execution strategy
    
    Default:
    
    io.quarkus.scheduler.Scheduled.ConcurrentExecution.PROCEED
- - skipExecutionIf
```
Class<? extends Scheduled.SkipPredicate> skipExecutionIf
```
    Specify the bean class that can be used to skip any execution of a scheduled method.
    There must be exactly one bean that has the specified class in its set of bean types, otherwise the build fails. Furthermore, the scope of the bean must be active during execution. If the scope is Dependent then the bean instance belongs exclusively to the specific scheduled method and is destroyed when the application is shut down.
    
    Returns:
    
    the bean class
    
    Default:
    
    io.quarkus.scheduler.Scheduled.Never.class
- - overdueGracePeriod
```
String overdueGracePeriod
```
    Defines a period after which the job is considered overdue.
    The value is parsed with Duration.parse(CharSequence). However, if an expression starts with a digit, "PT" prefix is added automatically, so for example, 15m can be used instead of PT15M and is parsed as "15 minutes". Note that the absolute value of the value is always used.
    The value can be a property expression. In this case, the scheduler attempts to use the configured value instead: @Scheduled(overdueGracePeriod = "${myJob.overdueExpression}"). Additionally, the property expression can specify a default value: @Scheduled(overdueGracePeriod = "${myJob.overdueExpression:5m}").
    
    Returns:
    
    the period expression based on the ISO-8601 duration format PnDTnHnMn.nS
    
    Default:
    
    ""

Annotation Type Scheduled

Optional Element Summary

Element Detail

identity

cron

every

delay

delayUnit

delayed

concurrentExecution

skipExecutionIf

overdueGracePeriod