ConvertBox Logo
ConvertBox

Expresiones cron explicadas: campos, ejemplos y errores comunes

Una expresión cron son cinco campos, minuto, hora, día del mes, mes y día de la semana, y cada uno describe un conjunto de valores permitidos. La tarea se ejecuta cuando la hora actual coincide con todos, con una excepción notable en los dos campos de día.

ConvertBoxPublicado

Los cinco campos, de izquierda a derecha

Una expresión cron clásica tiene cinco campos separados por espacios. Cron se despierta una vez por minuto y ejecuta la tarea si el minuto, la hora, el día y el mes actuales están cada uno en el conjunto que describe el campo correspondiente. La expresión es un filtro sobre el reloj, no un temporizador de intervalos, y esa distinción explica la mayoría de las sorpresas que aparecen más abajo.

CampoValores permitidosEjemplo
Minuto0-5930 significa en el minuto 30
Hora0-230 es medianoche, 13 es la 1 de la tarde
Día del mes1-3115 significa el día 15
Mes1-12 o JAN-DEC7 o JUL
Día de la semana0-6 o SUN-SAT0 es domingo; la mayoría de las implementaciones aceptan también 7

Cuatro caracteres especiales: * , - /

Cada campo contiene un único número o un conjunto construido con cuatro operadores. Se pueden combinar, como en 0-30/10 o 1,15,20-25.

CarácterSignificadoEjemplo en el campo de minutosSe ejecuta en los minutos
*Todos los valores*0, 1, 2 ... 59
,Lista5,355 y 35
-Rango con ambos extremos incluidos10-1310, 11, 12, 13
/Paso a lo largo del rango*/150, 15, 30, 45
- con /Paso dentro de un rango0-30/100, 10, 20, 30

Ejemplos resueltos, leídos campo por campo

Lee cada expresión desde el minuto hasta el día de la semana. Un primer error frecuente es dejar el minuto como *: la expresión * 9 * * * se ejecuta sesenta veces, una por minuto entre las 09:00 y las 09:59.

  • 0 9 * * 1-5: a las 09:00, de lunes a viernes.
  • */15 9-17 * * 1-5: cada 15 minutos durante las horas 9 a 17 en días laborables. El rango de horas incluye el extremo, así que la última ejecución es a las 17:45, no a las 17:00.
  • 0 */6 * * *: a las 00:00, 06:00, 12:00 y 18:00 todos los días.
  • 5,35 * * * *: dos veces por hora, en los minutos 5 y 35.
  • 30 2 1 * *: a las 02:30 del primer día de cada mes.
  • 0 22 * * 0: a las 22:00 todos los domingos.
  • 0 0 1 1 *: una vez al año, a medianoche del 1 de enero.

Por qué */7 y el día 31 se comportan de forma inesperada

Un paso no significa cada N unidades de tiempo transcurrido. Selecciona valores del rango del campo empezando por el más bajo, y la selección vuelve a empezar cuando el campo da la vuelta. En el campo de minutos, */7 coincide con 0, 7, 14 y así hasta 56, y luego otra vez con 0, lo que deja un hueco de 4 minutos al final de cada hora. En el campo de horas, */5 coincide con 0, 5, 10, 15 y 20, así que el hueco al cruzar la medianoche es de 4 horas. En el campo de día del mes, */2 coincide con los días impares, de modo que la tarea se ejecuta el 31 y otra vez el 1. Solo los pasos que dividen el rango de forma exacta, como 5, 10, 15, 20 o 30 para los minutos y 2, 3, 4, 6, 8 o 12 para las horas, dan un espaciado uniforme.

Los días que no existen simplemente nunca coinciden. 0 0 31 * * se ejecuta en los siete meses que tienen 31 días y se salta los otros cinco sin avisar; el día 30 se salta febrero, y el 29 solo se ejecuta en febrero en los años bisiestos. El cron estándar no tiene ningún símbolo para el último día del mes. La solución habitual es programar la tarea en los días 28-31 y hacer que el comando compruebe si mañana es día 1 antes de hacer nada.

El día del mes y el día de la semana se unen con OR

Todos los campos deben coincidir, con una excepción. Cuando tanto el campo de día del mes como el de día de la semana están restringidos, es decir, ninguno de los dos es *, el cron clásico ejecuta la tarea cuando coincide cualquiera de ellos. 0 0 13 * 5 no es el viernes 13: se ejecuta el día 13 de cada mes y también todos los viernes. Del mismo modo, 0 9 1-7 * 1 no significa el primer lunes; se ejecuta cada uno de los siete primeros días y además todos los lunes.

Cuando uno de los dos campos es *, solo el otro restringe la programación, que es el comportamiento que casi todo el mundo espera. Para una combinación real, restringe un campo en la expresión y comprueba el otro en el comando: programa 0 9 1-7 * * y haz que el script termine si hoy no es lunes. Los planificadores con sintaxis ampliada lo resuelven directamente; en Quartz, MON#1 en el campo de día de la semana significa el primer lunes del mes.

Zonas horarias y horario de verano

Una expresión no contiene zona horaria; la aporta el sistema que la ejecuta. Un crontab tradicional de Linux usa la hora local del servidor. Las programaciones de GitHub Actions son siempre UTC. Un CronJob de Kubernetes usa la zona del controlador del clúster salvo que se defina spec.timeZone. En un sistema en UTC, una tarea pensada para las 09:00 de Madrid debe escribirse con la hora 8 en invierno y la hora 7 en verano, porque la diferencia pasa de 1 hora a 2.

El horario de verano añade dos riesgos en las zonas que lo aplican. En el cambio de primavera hay una hora que no existe, así que una tarea programada dentro de ella puede no ejecutarse ese día; en el cambio de otoño una hora ocurre dos veces, así que una tarea dentro de ella puede ejecutarse dos veces. Cómo trata un planificador estos casos depende de la implementación. Programar en UTC, o mantener las tareas fuera de las horas del cambio en hora local, evita ambos.

Cron clásico, Quartz y los dialectos de cada plataforma

La sintaxis de cron es una familia, no una única norma. Una expresión de cinco campos no es válida en Quartz, y una expresión de Quartz no es válida en un crontab, así que comprueba qué dialecto espera una plataforma antes de copiar una programación de otro sitio.

El asistente de cron del sitio analiza los cinco campos estándar. Convierte la expresión en una frase en el idioma de la página y, por separado, muestra las cinco próximas ejecuciones en la zona horaria de tu navegador; cuando la frase y las fechas coinciden con lo que querías, la expresión es correcta para un planificador de cinco campos que funcione en esa zona. Las extensiones como L, W, # y ? pertenecen a las plataformas de la tabla, así que consulta su documentación. Una expresión regular puede confirmar que una cadena tiene cinco campos separados por espacios, lo cual es útil para validar entradas y fácil de probar en un probador de regex, pero no puede decirte cuándo se ejecutará la tarea.

DialectoCamposDiferencias que conviene conocer
crontab de Unix5Hora local del servidor; muchas implementaciones aceptan atajos como @daily y @hourly
Quartz6 o 7Segundos al principio y año opcional al final; ? obligatorio en uno de los dos campos de día; añade L, W y #
Spring @Scheduled6Segundos al principio, sin campo de año
AWS EventBridge6Minuto al principio, año al final, sin segundos; ? obligatorio en uno de los dos campos de día
GitHub Actions5Siempre UTC; el intervalo mínimo es cada 5 minutos; las ejecuciones pueden retrasarse con mucha carga
Kubernetes CronJob5Zona horaria del controlador salvo que se defina spec.timeZone

Herramientas mencionadas en esta guía

Guías relacionadas

Todas las guías