Referencia de sintaxis de programación de cron
En esta sección, se describe la sintaxis para definir ejecuciones programadas usando cron en Alteryx Analytics Cloud (AAC). Normalmente, este método se utiliza para programaciones repetidas.
Nota
Los ajustes de zona horaria definidos en la página
AAC en la que estás especificando tu horario cron se utilizan con la programación. Para usar la zona horaria UTC, selecciona
UTC
en la lista desplegable.
Visión general de cron
AAC te permite hacer uso de cron, una sintaxis ampliamente utilizada, para especificar tiempos que se repiten a intervalos regulares. Puedes usar cron para especificar las programaciones por minuto o anualmente y los intervalos arbitrarios en el medio.
Sintaxis de cron
Un cron programado se define como una cadena de valores separada por espacios. El siguiente ejemplo de cron define un programa que se activará a las 11:30:00 p. m. el 1 de febrero:
minuto | hora | día del mes | mes | día de la semana |
|---|---|---|---|---|
30 | 23 | 1 | 2 | * |
Cuando todos los valores coinciden, se activa la tarea cron.
Nota
La especificación de segundos no es compatible.
Comodines:
En la expresión cron anterior, el comodín * se puede utilizar para incluir cualquier valor aceptado, lo que significa que el tipo de valor cron no es un factor en la determinación de esta programación. Dado que el comodín se aplica al valor del día de la semana, el horario se puede activar en cualquier día de la semana.
Nota
Debes usar el carácter
*
en los campos día de la semana o día del mes. No se admite especificar ambos campos en la misma expresión cron.
Leyenda:
Excepto el campo final (año), todos los campos son requeridos en la expresión cron. Los caracteres especiales se describen debajo de la tabla.
Valor | Tipo | Descripción | Caracteres especiales admitidos |
|---|---|---|---|
30 | minuto | 0-59 | , - * / |
23 | hora | 0-23 | , - * / |
1 | día del mes | 1-31 | , - * / L W |
2 | mes | 1-12 | , - * / |
* | día de la semana | De 0 a 6 o dom-sáb 0, dom, DOM = Domingo 1, lunes, LUN = lunes ... 6, sáb, SÁB = Sábado | , - * / L # |
* | año | (Opcional) Puedes especificar la configuración del año si es necesario. De forma predeterminada es * . | , - * / |
Caracteres especiales
Puedes usar los siguientes caracteres especiales en tus expresiones de cron.
Carácter | Descripción |
|---|---|
* | (
“todos los valores”
): comodín para incluir todos los valores posibles en el campo. Por ejemplo, si querías que tu activador se disparara cada minuto de la hora de las 10 p. m., el carácter para el minuto en la expresión es
|
- | Especifica un rango de valores. Por ejemplo, puedes usar
|
, | Especifica un conjunto discreto de valores. Por ejemplo, una entrada de
|
/ | Especifica los incrementos del campo en las unidades del campo. Por ejemplo,
|
L | El último valor aceptado en el rango se acepta en los siguientes campos:
|
W | Especifica el día de semana coincidente más cercano. Por ejemplo, una entrada de
Sugerencia
|
# | Especifica el nro. de día del mes. Ejemplos para el campo del día de la semana:
|
Ejemplos
A continuación, se presentan algunos ejemplos de programaciones cron.
Por hora
Se ejecuta en el minuto 15 de cada hora:
15 * * * *
Diario
Se ejecuta todos los días a las 10 p. m.:
0 22 * * *
Se ejecuta cada minuto de la hora 10 p. m. todos los días:
* 22 * * *
Semanal
Se ejecuta todos los martes a las 3 a. m.:
0 3 * * 2
Días de la semana
Se ejecuta cada día de la semana a las 8 p. m.:
0 20 * * 1-5
Ten en cuenta que el programa anterior se ejecuta a las 8 p. m. el lunes por la noche y cada noche de la semana a esa hora.
Para cada mañana de día de la semana, puedes optar por iniciar las programaciones el domingo, en el que el valor del día de la semana comienza con 0 y termina con 4.
Mensual
Se ejecuta el primer día de cada mes a las 2:30 a. m.:
30 2 1 * *
Se ejecuta a las 3:30 p. m. del día de la semana más cercano (W) al 25 del mes:
30 15 25W * *
Si el día 25 es un sábado, lo anterior se activa el viernes 24.
Si el día 25 es un domingo, lo anterior se activa el lunes 26.
Anual
Se ejecuta a la medianoche del 1 de enero cada año:
0 0 1 1 * *
Otros ejemplos
Expresión | Significado |
|---|---|
0 12 * * * | Se activa a las 12 p. m. (mediodía) todos los días |
15 10 * * * | Se activa a las 10:15 a. m. todos los días |
15 10 * * * | Se activa a las 10:15 a. m. todos los días |
15 10 * * * * | Se activa a las 10:15 a. m. todos los días |
15 10 * * * 2017 | Se activa a las 10:15 a. m. todos los días durante el año 2017 |
* 14 * * * | Se activa cada minuto comenzando a las 2 p. m. y terminando a las 2:59 p. m., todos los días |
0/5 14 * * * | Se activa cada 5 minutos comenzando a las 2 p. m. y terminando a las 2:55 p. m., todos los días |
0/5 14,18 * * * | Se activa cada 5 minutos comenzando a las 2 p. m. y terminando a las 2:55 p. m. y se activa cada 5 minutos comenzando a las 6 p. m. y terminando a las 6:55 p. m., todos los días |
0-5 14 * * * | Se activa cada minuto comenzando a las 2 p. m. y terminando a las 2:05 p. m., todos los días |
10,44 14 * 3 WED | Se activa a las 2:10 p. m. y a las 2:44 p. m. todos los miércoles en el mes de marzo. |
15 10 * * MON-FRI | Se activa a las 10:15 a. m. todos los lunes, martes, miércoles, jueves y viernes |
15 10 15 * * | Se activa a las 10:15 a. m. en el día 15 de cada mes |
15 10 L * * | Se activa a las 10:15 a. m. en el último día de cada mes |
15 10 L-2 * * | Se activa a las 10:15 a. m. en el penúltimo día de cada mes |
15 10 * * 5L | Se activa a las 10:15 a. m. del último viernes de cada mes |
15 10 * * 5L 2017-2019 | Se activa a las 10:15 a. m. cada último viernes de cada mes durante los años 2017, 2018 y 2019 |
15 10 * * 5#3 | Se activa a las 10:15 a. m. del tercer viernes de cada mes |
0 12 1/5 * * | Se activa a las 12 p. m. (mediodía) cada 5 días cada mes, comenzando el primer día del mes. |
11 11 11 11 * | Se activa cada 11 de noviembre a las 11:11 a. m. |
Expresiones cron no admitidas
Nota
AAC no admite mezclar los caracteres especiales
/
y
-
en las mismas expresiones.
En lugar de expresar rangos en la sintaxis de cron, puedes hacer referencia a todas las opciones posibles.
Expresión no válida | Expresión válida |
|---|---|
0 23 * 1-11/2 * * | 0 23 * 2,4,6,8,10 * * |
Expresión cron no válida
Expresión | Significado | Razón |
|---|---|---|
15 10 * * * 2001 | Se activa a las 10:15 a. m. todos los días durante el año 2001 | Esta expresión de cron no es válida porque no generará ningún evento en el futuro. |
* * * | - | La expresión cron debe contener 6 o 7 campos. |