Cron-формат
Cron-формат - это простой, но мощный и гибкий способ описания времени и периодичности действий. nnCron активно использует cron-формат при указании временных интервалов и в классическом и в расширенном режимах.
Традиционный (унаследованный из мира Unix) cron-формат состоит из пяти полей, разделенных пробелами:
<Минуты> <Часы> <Дни_месяца> <Месяцы> <Дни_недели>
nnCron может работать и с традиционным, и с "улучшенным" вариантом cron-формата, который отличается от традиционного шестым добавленным полем - <Годы>:
<Минуты> <Часы> <Дни_месяца> <Месяцы> <Дни_недели> <Годы>
Пользователь сам может выбрать подходящий для него формат, снимая или устанавливая "галочку" в опции "Поле года" (Year field) диалогового окна "Параметры" (двойной щелчок на иконке nnCron в системном трее). По умолчанию nnCron использует "улучшенный" формат.
Вот его схема:
* * * * * * | | | | | | | | | | | +--- Годы (диапазон: 1900-3000) | | | | +----- Дни недели (диапазон: 1-7) | | | +------- Месяцы (диапазон: 1-12) | | +--------- Дни месяца (диапазон: 1-31) | +----------- Часы (диапазон: 0-23) +------------- Минуты (диапазон: 0-59)
Любое из шести полей может содержать символ * (звездочка) в качестве значения. Это означает полный диапазон возможных значений, например, каждая минута, каждый час и т. д. Пользователи nnCron могут также использовать в первых четырех полях "нестандартный" символ - ?. См. его описание ниже.
Любое из полей может содержать список значений, разделенных запятыми (например, 1,3,7) или интервал (поддиапазон) значений, обозначаемый дефисом (например, 1-5).
После звездочки (*) или интервала можно с помощью символа / указать шаг значений. Например, 0-23/2 может использоваться в поле "Часы" для указания того, что действие должно происходить каждые два часа (альтернатива из старого варианта - 0,2,4,6,8,10,12,14,16,18,20,22), значение */4 в поле "Минуты" означает, что действие, должно происходить каждые четыре минуты, 1-30/3 - это то же, что и 1,4,7,10,13,16,19,22,25,28.
В полях "Месяцы" и "Дни недели" можно вместо числовых значений использовать сокращенные до трех букв названия месяцев (Jan,Feb,...,Dec) и дней недели (Mon,Tue,...,Sun)
Примеры:
* * * * * * каждую минуту
59 23 31 12 5 * за минуту до конца года, если последний день года -
пятница
59 23 31 Dec Fri * за минуту до конца года, если последний день года -
пятница (еще один вариант записи)
45 17 7 6 * * Каждый год 7-го июня в 17:45
45 17 7 6 * 2001,2002 Раз в год 7-го июня в 17:45, если сейчас 2001-й или
2002-й год
0,15,30,45 0,6,12,18 1,15,31 * 1-5 * В 00:00, 00:15, 00:30, 00:45, 06:00, 06:15, 06:30,
06:45, 12:00, 12:15, 12:30, 12:45, 18:00, 18:15,
18:30, 18:45, если сейчас 1-е, 15-е или 31-е число
любого месяца и только по рабочим дням недели
*/15 */6 1,15,31 * 1-5 * В 00:00, 00:15, 00:30, 00:45, 06:00, 06:15, 06:30,
06:45, 12:00, 12:15, 12:30, 12:45, 18:00, 18:15,
18:30, 18:45, если сейчас 1-е, 15-е или 31-е число
любого месяца и только по рабочим дням недели (еще
один вариант записи)
0 12 * * 1-5 * (0 12 * * Mon-Fri *) В полдень по рабочим дням
* * * 1,3,5,7,9,11 * * Каждую минуту в январе, марте, мае, июле, сентябре
и ноябре
1,2,3,5,20-25,30-35,59 23 31 12 * * В последний день года в 23:01, 23:02, 23:03, 23:05,
23:20, 23:21, 23:22, 23:23, 23:24, 23:25, 23:30,
23:31, 23:32, 23:33, 23:34, 23:35, 23:59
0 9 1-7 * 1 * Первый понедельник каждого месяца, в 9 утра
0 0 1 * * * В полночь, первого числа, каждый месяц
* 0-11 * * * Каждую минуту до полудня
* * * 1,2,3 * * Каждую минуту в январе, феврале и марте
* * * Jan,Feb,Mar * * Каждую минуту в январе, феврале и марте
0 0 * * * * Каждый день в полночь
0 0 * * 3 * Каждую среду в полночь
В расширенном режиме строки сron-формата можно сокращать, отбрасывая крайне правые звездочки.
Примеры: (только для расширенного режима)
Полная запись Сокращенная запись * * * * * * 59 23 31 12 5 2003 59 23 31 12 5 2003 59 23 31 12 5 * 59 23 31 12 5 45 17 7 6 * * 45 17 7 6 0,15,30,45 0,6,12,18 1,15,31 * * * 0,15,30,45 0,6,12,18 1,15,31 0 12 * * 1-5 * 0 12 * * 1-5 * * * 1,3,5,7,9,11 * * * * * 1,3,5,7,9,11 1,2,3,5,20-25,30-35,59 23 31 12 * * 1,2,3,5,20-25,30-35,59 23 31 12 0 9 1-7 * 1 * 0 9 1-7 * 1 0 0 1 * * * 0 0 1 * 0-11 * * * * * 0-11 * * * 1,2,3 * * * * * 1,2,3 0 0 * * * * 0 0 0 0 * * 3 * 0 0 * * 3
И в классическом и в расширенном режимах пользователи nnCron могут использовать в первых четырех полях cron-формата нестандартный символ - ?. Он означает время старта nnCron, т. е. при обработке поля знак вопроса будет заменен на время старта nnCron: минуты - для поля минут, час для поля часов, день месяца для поля дней месяца и месяц для поля месяца.
Например, если написать:
Time: ? ? * * * *
то задача сработает в момент старта nnCron и продолжит срабатывать ежедневно в это же самое время (если, конечно, пользователь не перезагрузит nnCron снова) - знаки вопроса "заменятся" на время старта nnCron. Если nnCron стартовал, например, в 8:25, то знаки вопросов заменятся так:
Time: 25 8 * * * *
Вот еще несколько примеров:
\ запустится _только_ при старте nnCron \ (действует аналогично 'Time: START-TIME') Time: ? ? ? ? * * \ запустится при старте nnCron (например, в 10:15) \ и продолжит запускаться ровно через один час: \ в 11:15, 12:15, 13:15 и т. д. Time: ? * * * * * \ будет запускаться ежеминутно, в час старта nnCron. \ На следующий день (если крон не перезапускался) \ в этот же час каждую минуту и т. д. Time: * ? * * * * \ будет запускаться ежедневно, раз в пять минут, \ в час старта nnCron Time: */5 ? * * * *