Изменения документа Тип сигнала: по расписанию

Сводка

• Свойства страницы (1 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Содержимое

...	...	@@ -90,20 +90,14 @@
90	90
91	91	В каждой из позиций может быть задано:
92	92
93		-* число или список чисел, разделённых запятыми — фиксированное значение; диапазон допустимых значений: минута (0—59), час (0—23), день месяца (1—31), месяц (1—12), день недели (1—7, 1 — воскресенье);
	93	+* символ * — произвольное значение (каждую минуту, каждый день и проч.);
	94	+* фиксированное значение — число;
	95	+* несколько значений — список чисел, разделённых запятыми;
	96	+* диапазон диапазон допустимых значений: минута (0—59), час (0—23), день месяца (1—31), месяц (1—12), день недели (1—7, 1 — воскресенье);
94	94	* два числа, разделённых дефисом, для указания интервал значений с..по;
95		-* символ ##*## — произвольное значение (каждую минуту, каждый день и проч.);
96		-* два числа, разделенных символом косая черта ##М/N## — шаг выполнения: выполнять через каждые N часов / минут начиная с M .
97	97
	99	+Помимо фиксированных значений, в каждой позиции можно использовать следующие конструкции:
98	98
99		-
100		-Формат и символы:
101		-
102		-В каждой позиции, помимо фиксированных значений, можно использовать следующие конструкции:
103		-
104		-* * — произвольное значение;
105		-* , — несколько значений, разделённых запятыми;
106		-* - — диапазон значений;
107	107	* M/N — выполнение с шагом N, начиная со значения M,
108	108	* L — последний день месяца;
109	109	* L-n — за n дней до последнего дня месяца;
...	...	@@ -118,8 +118,43 @@
118	118	Нельзя одновременно указывать конкретный день месяца и конкретный день недели. Одно из этих полей должно содержать *.
119	119	{{/warning}}
120	120
121		-Примеры возможных расписаний (в качестве разделителей используются пробелы):
	115	+== Как читать и составлять Cron-расписание ==
122	122
	117	+**Порядок полей.** Запись читается слева направо: сначала //когда в течение часа// (минута), затем //в какой час//, затем //какой день месяца//, //какой месяц//, //какой день недели//. Платформа проверяет все пять условий одновременно: срабатывание возможно только если текущие дата и время подходят **каждой** позиции выражения.
	118	+
	119	+**Символ %%*%%.** Означает «без ограничения по этому полю». Например, в выражении ниже звёздочки в полях дня, месяца и дня недели означают «каждый календарный день», а %%0%% и %%12%% фиксируют минуту и час:
	120	+
	121	+{{code language="none"}}
	122	+0 12 * * *
	123	+{{/code}}
	124	+
	125	+**Списки и диапазоны.**
	126	+
	127	+* %%9,18%% в поле часа — запуск в 09:00 и 18:00;
	128	+* %%2-6%% в поле дня недели — с понедельника по пятницу (2 — понедельник, 6 — пятница);
	129	+* %%1,7%% — воскресенье и суббота.
	130	+
	131	+**Шаг %%M/N%% или %%*/N%%.**
	132	+
	133	+* %%*/30%% в минутах — каждые 30 минут (0, 30);
	134	+* %%5/15%% — каждые 15 минут, **начиная с 5-й** (5, 20, 35, 50);
	135	+* %%8-18/2%% в часах — каждые 2 часа в интервале с 8 до 18 включительно (8, 10, 12, …).
	136	+
	137	+**День месяца и день недели.** Если нужно «каждый понедельник», задайте день недели (например, %%2%%) и поставьте %%*%% в поле **день месяца**. Если нужно «15-е число каждого месяца», укажите %%15%% в дне месяца и %%*%% в дне недели. Одновременно задавать и конкретное число месяца, и конкретный день недели нельзя — одно из полей должно быть %%*%%.
	138	+
	139	+**Практический порядок настройки**
	140	+
	141	+1. Определите **время**: минута и час (точное или с шагом).
	142	+1. Решите, **как часто по календарю**: каждый день (%%* *%%), определённые месяцы, число месяца или дни недели.
	143	+1. Для редких случаев (последний день месяца, последний будний день, N-й четверг) используйте вкладку **Текстовый шаблон** и символы L, LW, W, #.
	144	+1. Сохраните задание только после проверки **текстового описания** под полем ввода.
	145	+
	146	+{{info}}
	147	+Секунда запуска в выражении не задаётся: система выбирает её случайно от 0 до 59, чтобы разнести нагрузку при массовом запуске заданий в одну и ту же минуту.
	148	+{{/info}}
	149	+
	150	+== Примеры расписаний ==
	151	+
123	123	* ##* * * * * ## — каждую минуту,
124	124	* 0 * * * * — в начале каждого часа,
125	125	* ##0 12 * 1,2 *## — каждый день в 12 часов дня в январе и феврале,
...	...	@@ -145,8 +145,7 @@
145	145	* ##0 20 * * 6## — в 20:00, только по пятницам,
146	146	* ##0 20 * * 6L ##— в 20:00, в последнюю пятницу вечера,
147	147	* ##59 23 * 4-6 *## — В 23:59 ежедневно во втором квартале,
148		-* 0 0 LW * * — в последний будний день месяца
149		-* ##0 0 15W * *## — в ближайший будний день к 15-му числу
	177	+* ##0 0 15W * *## — в ближайший будний день к 15-му числу.
150	150
151	151	{{info}}
152	152	Вы можете выбрать одно из типовых расписаний из примеров и впоследствии отредактировать. Для этого нажмите на кнопку **Применить**.