Skip to main content

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 * . Hay un ejemplo abajo.

-

Especifica un rango de valores. Por ejemplo, puedes usar 1-5 en el campo día de la semana para incluir los días de trabajo de la semana (de lunes a viernes). Hay un ejemplo abajo.

,

Especifica un conjunto discreto de valores. Por ejemplo, una entrada de 1, 10, 20, 30 para el campo día del mes se activa en el 1, 10, 20 y 30 (si es posible) del mes.

/

Especifica los incrementos del campo en las unidades del campo. Por ejemplo, 5/20 en el campo de minutos incluye los minutos 5, 25 y 45 de cada hora.

L

El último valor aceptado en el rango se acepta en los siguientes campos:

  • Día-del-mes: especifica el último día del mes para el valor del mes seleccionado actualmente.

    • En enero, este valor coincide con 31 .

    • En febrero, este valor coincide con 28 para los años no bisiestos.

    • En abril, este valor coincide con 30 .

  • Día-de-la-semana:

    • Por sí mismo, especifica el último día de la semana, que coincide con 6 (sábado).

    • Cuando se usa con otro valor, especifica el último valor coincidente del mes. Por ejemplo, 3L es el último miércoles del mes.

W

Especifica el día de semana coincidente más cercano. Por ejemplo, una entrada de 22W en el campo del día del mes coincide con el día laboral más cercano al 22 del mes. Si el día 22 es un sábado, entonces la tarea cron busca el día 24 (el lunes siguiente).

Sugerencia

LW se puede utilizar en el campo del día del mes para buscar el último día de la semana del mes.

#

Especifica el nro. de día del mes. Ejemplos para el campo del día de la semana:

  • 3#4 : cuarto martes del mes

  • 5#2 : segundo jueves del mes

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.