Generador y validador de expresiones cron de AWS
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 #.
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.
| Campo | Valores | Comodines |
|---|---|---|
| Minutos | 0–59 | , - * / |
| Horas | 0–23 | , - * / |
| Día del mes | 1–31 | , - * ? / L W |
| Mes | 1–12 o JAN–DEC | , - * / |
| Día de la semana | 1–7 o SUN–SAT (1 = domingo) | , - * ? L # |
| Año | 1970–2199 | , - * / |
Comodines
,añade valores:JAN,FEB,MARen el mes significa enero, febrero y marzo.-es un rango:1-15en 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-2en 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/10en 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:7en 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.Les el último día: del mes en el día del mes, de la semana en el día de la semana.6Len el día de la semana es el último viernes del mes.Wes el día laborable más cercano:3Wes 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#2es 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í que3#1,6#3no 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
| Expresión | Se 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.
| Diferencia | Cron de Unix | Cron de AWS |
|---|---|---|
| Campos | 5: minuto, hora, día del mes, mes, día de la semana | 6: los mismos cinco más el año, dentro de cron( ) |
| Día del mes y día de la semana | Se pueden definir los dos; si ambos están restringidos, la tarea se ejecuta cuando coincide cualquiera | Uno de los dos debe ser ?; no puedes restringir ambos |
| Domingo | 0 (y 7 en la mayoría de versiones); los días van de 0 a 6 | 1; 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 semana | Permitidos en la mayoría de versiones | No 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 horaria | La zona horaria del servidor | UTC 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)yrate(5 hours)son válidas,rate(1 hours)yrate(5 hour)no. - La guía de EventBridge Scheduler indica las unidades como
minutes | hours | daysy ella misma escriberate(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.
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 →