Cómo construir expresiones cron

Las expresiones cron son la forma estándar de definir horarios recurrentes en Linux, plataformas en la nube, pipelines CI/CD y planificadores de tareas. La sintaxis es compacta pero poco intuitiva: construir un generador cron visual te muestra exactamente cuándo se ejecutará tu tarea, atrapa errores comunes antes del despliegue y elimina las conjeturas de la parte más propensa a errores de la automatización. Una vez que comprendes los cinco campos, los caracteres especiales y los errores más comunes, puedes especificar cualquier horario recurrente con confianza.

Breve historia de cron

El primer cron vino de Brian Kernighan en la versión 7 de Unix, alrededor de 1979. Releía su configuración cada minuto y ejecutaba todo lo que estuviera pendiente. Paul Vixie lo reescribió en 1987 en lo que ahora se llama Vixie cron, que es la versión que la mayoría de distribuciones Linux aún llevan. Vixie cron añadió crontabs por usuario, variables de entorno, la palabra clave @reboot y varias características de comodidad que hicieron el formato utilizable para no administradores.

La sintaxis de 5 campos apenas ha cambiado en más de cuarenta años. Amazon EventBridge, Google Cloud Scheduler, Kubernetes CronJob, GitHub Actions, GitLab CI, Jenkins, Airflow, n8n y docenas de otros sistemas consumen el mismo formato compacto con solo extensiones menores. Esa estabilidad es la razón por la que cron vale la pena aprender una vez y nunca volver a aprender. La habilidad se transfiere a todas partes donde la automatización funciona con reloj.

Sintaxis cron

Una expresión cron estándar tiene 5 campos, separados por espacios. Cada campo controla una porción de tiempo, y una tarea se ejecuta cuando cada campo coincide con el momento actual.

┌───────────── minuto (0-59)
│ ┌───────────── hora (0-23)
│ │ ┌───────────── día del mes (1-31)
│ │ │ ┌───────────── mes (1-12, o JAN-DEC)
│ │ │ │ ┌───────────── día de la semana (0-6, Dom=0, o SUN-SAT)
│ │ │ │ │
* * * * *

Los campos se combinan con Y para hora, minuto y mes, pero día-del-mes y día-de-la-semana se combinan con O en Vixie cron. Eso significa que 0 12 1 * 1 se dispara el 1 de cada mes Y cada lunes al mediodía, no solo los lunes que caen el 1. Este truco atrapa a casi todos la primera vez.

Horarios cron comunes

Los patrones a los que recurrirás con más frecuencia:

Muchos sistemas también aceptan alias abreviados que se expanden a la expresión de 5 campos equivalente: @yearly, @monthly, @weekly, @daily, @hourly y @reboot. Son concisos pero no universales, así que verifica tu plataforma antes de confiar en ellos.

Cómo construir una expresión cron

1. Elige la granularidad: ¿necesitas cada minuto, cada hora, una vez al día, una vez a la semana o una vez al mes? Empieza con el ajuste más grueso que cubra tu necesidad.
2. Usa los controles visuales: selecciona valores de minuto, hora, día, mes y día de la semana en los menús desplegables. O empieza con un preajuste como "cada hora" o "diario a medianoche" y ajusta.
3. Previsualiza las próximas ejecuciones: el generador muestra los próximos 5 horarios de ejecución, lo que te permite confirmar que el horario se dispara cuando esperas.
4. Verifica el huso horario: la previsualización debe coincidir con el huso del servidor o planificador que ejecutará la tarea, no con tu hora local.
5. Copia la expresión y pégala en tu crontab, YAML de GitHub Actions, regla de AWS EventBridge o el planificador que uses.
6. Prueba primero con un intervalo corto antes de fijar el horario final. Un rápido */5 * * * * prueba que la tarea se dispara; cuando veas dos o tres ejecuciones, cambia a la expresión real.

Caracteres y operadores especiales

Cron admite un pequeño pero potente conjunto de operadores dentro de cualquier campo.

Vixie cron clásico solo admite las primeras cinco filas. Los operadores avanzados (L, W, #, ?) vienen de Quartz, la biblioteca de planificación Java, y fueron adoptados por AWS EventBridge y unos pocos planificadores cloud más. No son portables, así que no los mezcles con código que tiene que ejecutarse en una caja Linux genérica.

Cron en diferentes plataformas

Cron es una familia de sintaxis relacionadas, no un estándar único. Saber qué dialecto habla tu planificador ahorra horas de depuración.

Si escribes un horario que tiene que correr en más de una plataforma, atente al subconjunto conservador de 5 campos que todo sistema entiende. Recurre a L, W o # solo cuando sepas que el destino los soporta.

Errores comunes

• Día-del-mes y día-de-la-semana se combinan con O, una expresión como 0 9 15 * 1 se dispara cada lunes Y el 15 de cada mes, no solo el 15 cuando cae en lunes. Para intersectar, normalmente necesitas un envoltorio externo o un planificador distinto.
• Confusión de huso horario, las crontabs de servidor corren casi siempre en UTC. Si quieres las 9 AM hora del Este, eso es 0 14 * * * UTC en invierno pero 0 13 * * * UTC en verano por el horario de verano. Usa un planificador que admita pistas de huso, o normaliza todo a UTC.
• Transiciones de horario de verano, las tareas planificadas a las 02:30 hora local pueden ejecutarse dos veces cuando se retrasan los relojes y no ejecutarse cuando se adelantan. Planifica tareas sensibles fuera de la ventana 01:00-03:00 o usa UTC.
• El truco de MAILTO de Vixie, si tu tarea imprime algo en stdout, Vixie cron envía la salida por correo al usuario propietario de la crontab. En servidores sin relay de correo esto llena /var/spool/mail rápidamente. Redirige la salida a un archivo de log con >>/var/log/myjob.log 2>&1.
• El entorno no es tu shell de login, cron corre con un entorno despojado: sin PATH de tu .bashrc, sin virtualenv, sin nvm. Define las variables que necesites al principio de la crontab o llama a tu script con ruta absoluta.
• Los signos de porcentaje necesitan escape, un % sin escapar en una crontab Vixie se interpreta como un carácter de nueva línea en el comando. Escápalo siempre como \% si tu comando necesita un porcentaje literal, por ejemplo en una invocación date +"%Y-%m-%d".
• Las tareas largas se solapan, cron no salta una ejecución porque la anterior siga corriendo. Si tu tarea puede tardar más que el intervalo, envuélvela en un archivo de bloqueo (flock, setlock) o usa un ejecutor que maneje concurrencia.
• Desbordamiento en el minuto 59, */40 * * * * no se dispara cada 40 minutos. Se dispara en el minuto 0 y 40 de cada hora porque los valores de paso dan la vuelta en los límites del campo. Para intervalos reales de 40 minutos necesitas un planificador más rico.
• Olvidar 0 en el campo minuto, * 9 * * * corre cada minuto de 09:00 a 09:59, no una vez a las 09:00. El campo minuto necesita un valor explícito si quieres un único disparo por hora.
• Cron no es fiable en portátiles, anacron existe por esa razón. Vixie cron no recupera ejecuciones perdidas tras un suspendido, así que un respaldo diario planificado a las 03:00 no correrá si el portátil estaba cerrado a esa hora. Usa anacron, timers de systemd con Persistent=true, o un plist de launchd en macOS.

Alternativas a cron

Para algunas cargas de trabajo la resolución gruesa por minuto de cron y la falta de contabilidad empiezan a doler. Las mejoras más comunes:

Cron sigue siendo la respuesta correcta para la gran mayoría de tareas recurrentes de una sola pieza. Las otras herramientas brillan cuando necesitas estado, reintentos, dependencias o coordinación entre máquinas.

Privacidad y el generador cron

El generador de expresiones cron corre completamente en tu navegador. El horario que construyes, la previsualización de próximas ejecuciones y la expresión copiada nunca tocan nuestros servidores. No hay registro de qué expresiones se generaron, ni telemetría sobre qué preajustes son populares, ni manera de que nadie reconstruya en qué horario estabas trabajando. Las expresiones cron no son datos personales a primera vista, pero el horario de una tarea (una exportación de base de datos nocturna, una ejecución de facturación semanal, una sincronización horaria con un socio) puede revelar mucho sobre cómo opera un negocio. Mantener esa información del lado del cliente evita filtrar accidentalmente patrones de infraestructura a un tercero. Para una tarea tan rutinaria como elegir un horario, el ajuste de privacidad por defecto debe coincidir con la sensibilidad de lo que esos horarios representan.