Analizador y explicador de expresiones cron

Leer una expresión cron

Una expresión cron tiene cinco campos que se leen de izquierda a derecha: minuto, hora, día del mes, mes y día de la semana. Un asterisco significa «todos los valores». 30 2 * * 1 se ejecuta a las 02:30 todos los lunes, y */15 9-17 * * MON-FRI se ejecuta cada 15 minutos de 09:00 a 17:45 en días laborables, 36 veces al día.

El analizador traduce la expresión a lenguaje corriente, calcula la próxima ejecución a partir de una fecha y hora de inicio en UTC, lista hasta 50 ejecuciones siguientes y cuenta cuántas caen en cada día válido. Con la expresión inicial y un inicio el jueves 15 de enero de 2026 a las 00:00 UTC, la próxima ejecución es jue 2026-01-15 09:00 UTC, nueve horas después, y el día tiene 36 ejecuciones.

Los cinco campos

1. Minuto: 0–59
2. Hora: 0–23
3. Día del mes: 1–31
4. Mes: 1–12, o JAN–DEC
5. Día de la semana: 0–7, o SUN–SAT; tanto 0 como 7 son domingo

Cada campo admite * para todos los valores, un número suelto, una lista separada por comas (5,20,50), un intervalo con guion (9-17) o un paso con barra (*/15, 10-40/15). Los nombres de meses y días son las abreviaturas inglesas de tres letras, y da igual escribirlas en mayúsculas o minúsculas.

El manual crontab(5) de cronie y Vixie cron define esta gramática, que es la que siguen la mayoría de los crontab de Linux.

Programaciones habituales

• Cada 5 minutos: */5 * * * *, 288 ejecuciones al día
• Cada hora en punto: 0 * * * *, o @hourly
• Todos los días a medianoche: 0 0 * * *, o @daily
• Todos los días a las 02:30: 30 2 * * *
• Los días laborables a las 09:00: 0 9 * * 1-5
• Todos los domingos a medianoche: 0 0 * * 0, o @weekly
• El día 1 de cada mes a medianoche: 0 0 1 * *, o @monthly
• Cada 1 de enero a medianoche: 0 0 1 1 *, o @yearly

Cómo funcionan los pasos

Un paso cuenta desde el principio de su intervalo y vuelve a empezar cada hora o cada día. */15 en el campo de minutos significa 0, 15, 30 y 45, y 10-40/15 significa 10, 25 y 40.

Como los pasos se reinician, no siempre dan intervalos regulares. */35 * * * * se ejecuta en los minutos 0 y 35, así que las esperas alternan entre 35 y 25 minutos.

0 */5 * * * se ejecuta a las 00:00, 05:00, 10:00, 15:00 y 20:00, y después solo espera 4 horas hasta la medianoche. Para que un paso empiece en otro valor hay que darle un intervalo: 1-59/5 se ejecuta en los minutos 1, 6, 11 y así sucesivamente.

Cuando los dos campos de día están restringidos

Si el día del mes y el día de la semana están restringidos a la vez, cron se ejecuta cuando coincide cualquiera de los dos. 0 12 1 * MON se ejecuta a mediodía el día 1 de cada mes y también todos los lunes, no solo los lunes que caen en día 1.

En cronie y Vixie cron, un campo de día que empieza por * convierte esa regla en una condición conjunta. Por eso 0 0 */2 * FRI solo se ejecuta los viernes de fecha impar, ya que */2 cuenta los días 1, 3, 5 y siguientes. La calculadora aplica la misma regla y lo explica en el paso «Combinar los dos campos de día».

Próximas ejecuciones de cinco programaciones

«Predeterminado» es */15 9-17 * * MON-FRI. Todas las filas parten del 15 de enero de 2026 a las 00:00 UTC salvo «Cada cinco minutos», que parte de las 12:35 y se ejecuta por primera vez a las 12:40, porque la lista empieza estrictamente después del inicio.

«Días bisiestos» es 0 0 29 FEB *, y las dos últimas filas son los ejemplos de campos de día del apartado anterior. La última columna cuenta las horas de ejecución dentro de un día que cumple la expresión, aunque la mayoría de los años no tengan 29 de febrero.

Zonas horarias y cambio de hora

Estas horas están en UTC. Un servicio cron usa la zona horaria local del servidor, salvo que el crontab defina CRON_TZ (en cronie). La calculadora muestra ese recordatorio con cada resultado.

El día del cambio de hora, una tarea programada a las 02:30 en hora local puede saltarse o desplazarse. Los servidores que funcionan en UTC evitan el problema.

Errores frecuentes con cron

• Escribir * 9 * * * para «a las 9 de la mañana». Esa expresión se ejecuta cada minuto de 09:00 a 09:59, 60 veces. La forma correcta es 0 9 * * *.
• Usar seis campos. Quartz y Spring anteponen un campo de segundos, como en 0 0/15 * * * ?. Crontab admite cinco campos, y ?, L, W y # pertenecen a esos otros dialectos.
• Intervalos que dan la vuelta. Aquí 22-2 se rechaza; para cubrir de 22:00 a 02:00 hay que escribir 22-23,0-2.
• Un % sin escapar en la orden. Crontab convierte el % de la parte de la orden en un salto de línea, así que date +%F debe escribirse date +\%F.
• Fechas imposibles. 0 0 30 2 * nunca se ejecuta, porque febrero no tiene día 30, y la calculadora lo indica en lugar de devolver una fecha.

Sintaxis admitida y alcance de la búsqueda

• Cinco campos, o una de las macros @hourly, @daily, @midnight, @weekly, @monthly, @yearly y @annually. @reboot no tiene una hora de calendario que listar.
• Hasta 50 ejecuciones siguientes, buscadas en un ciclo gregoriano completo de 400 años, de modo que reglas como que 2100 no sea bisiesto quedan cubiertas.

Para la distancia entre dos fechas de calendario, usa la calculadora de diferencia entre fechas.