Cron-выражения

Все cron-выражения в Spring должны соответствовать одному и тому же формату, независимо от того, используете ли вы их в аннотациях @Scheduled, элементах task:scheduled-tasks или где-то еще. Правильно сформированное выражение в формате cron, такое как * * * * * *, состоит из шести полей времени и даты, разделенных пробелами, каждое из которых имеет свой диапазон допустимых значений:

 ┌───────────── секунда (0-59)
 │ ┌───────────── минута (0 - 59)
 │ │ ┌───────────── час (0 - 23)
 │ │ │ ┌───────────── день месяца (1 - 31)
 │ │ │ │ ┌───────────── месяц (1 - 12) (или JAN-DEC)
 │ │ │ │ │ ┌───────────── день недели (0 - 7)
 │ │ │ │ │ │          (0 или 7 – воскресенье, или MON-SUN)
 │ │ │ │ │ │
 * * * * * *

Существуют определенные правила:

• Поле может быть звездочкой (*), которая всегда обозначает "первый-последний". Для полей "день месяца" или "день недели" вместо звездочки можно использовать знак вопроса (?).

• Запятые (,) используются для разделения элементов списка.

• Два числа, разделенные дефисом (-), выражают диапазон чисел. Заданный диапазон указывается включительно.

• После диапазона (или *) с помощью / задается интервал значения числа через диапазон.

• Для полей "день месяца" и "день недели" также можно использовать английские имена. Используйте первые три буквы конкретного дня или месяца (регистр не имеет значения).

• Поля "день месяца" и "день недели" могут содержать символ L, который имеет иное значение

  • В поле "день месяца" L означает последний день месяца. Если за ним следует отрицательное смещение (т.е. L-n), это означает n-дней до последнего дня месяца.

  • В поле "день недели" L означает последний день недели. Если перед ним стоит цифра или трехбуквенное название (dL или DDDL), это означает последний день недели (d или DDD) в месяце.

• Поле дня месяца может быть стоять nW, что означает ближайший будний день к n-дню месяца. Если n выпадает на субботу, это дает пятницу перед ней. Если n выпадает на воскресенье, это дает следующий за ним понедельник, что также происходит, если n равно 1 и выпадает на субботу (т.е: 1W означает первый будний день месяца).

• Если в поле "день месяца" стоит LW, это означает последний будний день месяца.

• Поле "день недели" может быть d#n (или DDD#n), что означает n-й день недели d (или DDD) в месяце.

Вот несколько примеров:

Макросы

Такие выражения, как 0 0 0 * * * * *, разбирать человеку тяжело и, следовательно, трудно исправлять в случае ошибок. Для улучшения читабельности Spring поддерживает следующие макросы, которые представляют часто используемые последовательности. Можно использовать эти макросы вместо шестизначного значения, таким образом: @Scheduled(cron = "@hourly").