CloudConsole

Generador y validador de expresiones cron de AWS

Gratis, en tu navegador · EventBridge Scheduler y reglas · funciona sin conexión

Crea y comprueba una expresión

Todo funciona en tu navegador, también sin conexión: nada de lo que escribes se envía a ningún sitio. Comparte una programación copiando la dirección de la página; la expresión se guarda después del #.

Respuesta corta

Una expresión cron de AWS tiene seis campos, minutos, horas, día del mes, mes, día de la semana y año, dentro de cron(): cron(0 9 ? * MON-FRI *) se ejecuta a las 09:00 cada día laborable. Uno de los dos campos de día debe ser ?, el día de la semana va de 1 = domingo a 7 = sábado, y las reglas de EventBridge se ejecutan en UTC, mientras que EventBridge Scheduler puede usar cualquier zona horaria.

Sintaxis cron de AWS: los seis campos

Las reglas programadas de EventBridge y EventBridge Scheduler usan el mismo formato cron: cron(minutes hours day-of-month month day-of-week year). Los seis campos son obligatorios y van separados por espacios.

Campos cron de AWS, valores permitidos y comodines
CampoValoresComodines
Minutos0–59, - * /
Horas0–23, - * /
Día del mes1–31, - * ? / L W
Mes1–12 o JAN–DEC, - * /
Día de la semana1–7 o SUN–SAT (1 = domingo), - * ? L #
Año1970–2199, - * /

Comodines

  • , añade valores: JAN,FEB,MAR en el mes significa enero, febrero y marzo.
  • - es un rango: 1-15 en el día del mes son los días 1 a 15. Los propios ejemplos de AWS incluyen un rango que pasa la medianoche, 20-2 en las horas.
  • * significa todos los valores. No puedes usarlo a la vez en el día del mes y en el día de la semana.
  • / es un incremento: 1/10 en los minutos se ejecuta en los minutos 1, 11, 21 y así sucesivamente; 0/15, cada 15 minutos desde la hora en punto. El día de la semana no lo admite.
  • ? significa «cualquiera» y va en el campo de día que no usas: 7 en el día del mes con ? en el día de la semana se ejecuta el día 7, sea el día de la semana que sea.
  • L es el último día: del mes en el día del mes, de la semana en el día de la semana. 6L en el día de la semana es el último viernes del mes.
  • W es el día laborable más cercano: 3W es el día laborable más próximo al día 3 del mes.
  • # es el enésimo día de la semana del mes: 3#2 es el segundo martes (3 es martes, el tercer día de la semana). Un campo de día de la semana con # solo puede contener esa expresión, así que 3#1,6#3 no es válido.

Hay dos límites que se aplican a toda expresión: no puedes definir los dos campos de día (uno debe ser ?), y no se admiten expresiones cron que se ejecutarían más de una vez por minuto.

Ejemplos

Ejemplos de expresiones cron de AWS
ExpresiónSe ejecuta
cron(0 10 * * ? *)10:00 UTC todos los días
cron(15 12 * * ? *)12:15 UTC todos los días
cron(0 18 ? * MON-FRI *)18:00 UTC, de lunes a viernes
cron(0 8 1 * ? *)08:00 UTC el día 1 de cada mes
cron(0/15 * * * ? *)Cada 15 minutos
cron(0/10 * ? * MON-FRI *)Cada 10 minutos, de lunes a viernes
cron(0/5 8-17 ? * MON-FRI *)Cada 5 minutos de 08:00 a 17:55 UTC, de lunes a viernes
cron(15 10 ? * 6L 2019-2022)10:15 UTC el último viernes de cada mes, de 2019 a 2022
cron(0 12 ? * 3#2 *)12:00 el segundo martes de cada mes
cron(0 9 15W * ? *)09:00 el día laborable más cercano al 15

Los ocho primeros son de la documentación de AWS. En las reglas de EventBridge las horas son UTC; en EventBridge Scheduler están en la zona horaria de la programación.

En qué se diferencia el cron de AWS del cron de Unix

Una línea de crontab no funciona tal cual. Pégala en el generador y te propone la versión de AWS.

Cron de Unix comparado con el cron de AWS
DiferenciaCron de UnixCron de AWS
Campos5: minuto, hora, día del mes, mes, día de la semana6: los mismos cinco más el año, dentro de cron( )
Día del mes y día de la semanaSe pueden definir los dos; si ambos están restringidos, la tarea se ejecuta cuando coincide cualquieraUno de los dos debe ser ?; no puedes restringir ambos
Domingo0 (y 7 en la mayoría de versiones); los días van de 0 a 61; los días van de 1 a 7, de SUN a SAT
Cada 5 minutos*/5 * * * *cron(0/5 * * * ? *) o rate(5 minutes)
Incrementos en el día de la semanaPermitidos en la mayoría de versionesNo permitidos: enumera los días
L, W y #No existen en el cron estándarÚltimo día (L, 6L), día laborable más cercano (15W), enésimo día de la semana (3#2)
Zona horariaLa zona horaria del servidorUTC en las reglas de EventBridge; cualquier zona horaria IANA por programación en EventBridge Scheduler

Ninguno de los dos tiene campo de segundos. Las expresiones de Quartz y Spring sí; quita su primer campo para obtener la forma de AWS.

Expresiones rate()

Para un intervalo fijo, rate(value unit) es más sencillo: rate(5 minutes), rate(1 hour), rate(12 hours), rate(1 day). El valor es un número entero positivo y la unidad es minutos, horas o días; no hay segundos, semanas ni meses.

  • Las reglas de EventBridge necesitan la unidad en singular para un valor de 1 y en plural por encima de 1: rate(1 hour) y rate(5 hours) son válidas, rate(1 hours) y rate(5 hour) no.
  • La guía de EventBridge Scheduler indica las unidades como minutes | hours | days y ella misma escribe rate(1 days).

Una programación rate cuenta desde que empieza, no según el reloj: desde que creas la regla, o desde la StartDate de una programación de Scheduler (sin ella, empieza a invocar de inmediato). Usa cron cuando tenga que ejecutarse en minutos concretos.

Zonas horarias y horario de verano

Las reglas de EventBridge evalúan el cron en UTC, y todos los ejemplos de AWS están en UTC+0. Para ejecutar a las 09:00 de Nueva York, tienes que calcular tú la hora UTC y cambiarla cuando cambia la hora.

EventBridge Scheduler evalúa las programaciones cron y puntuales en la zona horaria que le des (--schedule-expression-timezone, o ScheduleExpressionTimezone en CloudFormation), de la base de datos de zonas horarias IANA, y tiene en cuenta el horario de verano:

  • Cuando se adelanta la hora, una ejecución que cae en la hora que falta se omite ese día.
  • Cuando se atrasa la hora, una hora que ocurre dos veces se ejecuta solo una, en la segunda.
  • rate(1 days) significa 24 horas, así que en un día de 23 o 25 horas se desplaza una hora respecto al reloj.

El generador sigue estas reglas y marca las horas omitidas o repetidas. Scheduler invoca los destinos con una precisión de 60 segundos: una ejecución prevista para la 1:00 ocurre entre la 1:00:00 y la 1:00:59, salvo que definas una ventana de tiempo flexible.

Programaciones puntuales: at()

EventBridge Scheduler también puede invocar un destino una sola vez en un momento dado: at(2026-12-31T23:30:00), en la zona horaria de la programación. Las reglas de EventBridge no lo admiten. Una programación puntual sigue contando para tu cuota de programaciones después de ejecutarse, así que AWS recomienda eliminarla después.

Fuentes

Preguntas frecuentes

¿Por qué AWS dice «Parameter ScheduleExpression is not valid»?

EventBridge comprueba la expresión entera y la rechaza con esa ValidationException si alguna parte incumple una regla. Las causas habituales son cinco campos en lugar de seis, * tanto en el día del mes como en el día de la semana (uno debe ser ?), 0 para el domingo (AWS cuenta de 1 a 7 desde el domingo), un incremento / en el día de la semana o rate(1 minutes) en lugar de rate(1 minute). Pega la expresión en el generador de arriba para ver qué campo falla.

¿El cron de AWS está en UTC?

En las reglas programadas de EventBridge, sí: la expresión siempre se evalúa en UTC. EventBridge Scheduler te permite fijar una zona horaria por programación (ScheduleExpressionTimezone, cualquier nombre IANA como Europe/Madrid) y tiene en cuenta el horario de verano; sin ella, usa UTC.

¿Cómo ejecuto una función Lambda cada 5 minutos?

Usa rate(5 minutes) o cron(0/5 * * * ? *). Con EventBridge Scheduler, crea una programación con la función como destino y un rol que Scheduler pueda asumir. Con una regla de EventBridge, añade la función como destino y da permiso a EventBridge para invocarla con aws lambda add-permission.

¿Qué significa ? en una expresión cron de AWS?

«Cualquiera». El cron de AWS tiene campos separados para el día del mes y el día de la semana y no permite restringir los dos, así que el que no usas debe ser ?. Por ejemplo, cron(0 9 ? * MON *) se ejecuta los lunes y cron(0 9 1 * ? *) el día 1.

¿Puede una programación de EventBridge ejecutarse más de una vez por minuto?

No. No se admiten expresiones cron que den lugar a frecuencias por debajo del minuto, y rate() acepta minutos, horas o días. Además, EventBridge Scheduler invoca los destinos con una precisión de 60 segundos: una programación para la 1:00 se ejecuta entre la 1:00:00 y la 1:00:59.

¿El generador envía mis expresiones a algún sitio?

No. El análisis y el cálculo de las horas de ejecución ocurren en tu navegador, incluida la conversión de zona horaria, que usa los datos de zonas horarias integrados en tu navegador. Nada de lo que escribes se envía y la página no usa cookies.

Cuando una tarea programada falla a las 3 de la madrugada

EventBridge, Lambda y las alarmas y logs de CloudWatch tienen sus propias pantallas en CloudConsole, así que puedes ver qué alarma saltó y leer los logs de la ejecución desde el móvil, en iPhone y Android.

Sobre la app →