Calcular las próximas ejecuciones de una expresión cron

Una expresión cron es una cadena corta que describe una recurrencia en el tiempo. El formato heredado de Unix ocupa cinco campos separados por espacios: minuto, hora, día del mes, mes y día de la semana. Esta sintaxis nació con el demonio cron de Brian Kernighan en los años 70 y, después, se generalizó con el Vixie cron (1987) adoptado por todas las distribuciones Linux y macOS modernas. Hoy en día, la misma sintaxis se encuentra en la mayoría de planificadores cloud (AWS EventBridge, GCP Cloud Scheduler, Azure Logic Apps) y CI/CD (GitHub Actions, GitLab CI, Jenkins).

┌──── minute (0-59)
│ ┌── heure (0-23)
│ │ ┌── jour du mois (1-31)
│ │ │ ┌── mois (1-12 ou JAN-DEC)
│ │ │ │ ┌── jour de la semaine (0-7 ou SUN-SAT, 0 et 7 = dimanche)
│ │ │ │ │
* * * * *

Una expresión cron bien formada define, por tanto, un cron schedule preciso: cada campo puede ser un valor fijo, un rango, una lista, un paso o un asterisco que coincide con todo. La compacidad de la expresión crontab es su fuerza, pero también es lo que hace que un cron decoder sea indispensable para validar visualmente la intención. Ese es todo el objetivo de este cron converter: producir una explicación cron legible, más la lista de las próximas ejecuciones.

Los cinco campos comparten una gramática común. Estos son los límites aceptados por cada columna de una expresión crontab estándar:

• Minuto: 0-59.
• Hora: 0-23, formato 24 h.
• Día del mes: 1-31.
• Mes: 1-12 o las abreviaturas textuales JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
• Día de la semana: 0-7, donde 0 y 7 representan ambos al domingo, o las abreviaturas SUN, MON, TUE, WED, THU, FRI, SAT.

Caracteres especiales compartidos por los cinco campos:

• *: any value, coincide con todos los valores autorizados del campo.
• ,: lista discreta, por ejemplo 1,15,30 en el campo minuto.
• -: rango inclusivo, por ejemplo 9-17 para las horas de oficina.
• /: paso (step), por ejemplo */15 = cada 15 unidades, o 0-30/5 = cada 5 minutos entre 0 y 30.

Extensiones Quartz (Java, AWS EventBridge, Spring): la gramática sube a 6 o 7 campos con una columna segundos al inicio (0-59) y, a veces, una columna año al final (1970-2099). Quartz también introduce ? (no specific value, para desacoplar día-del-mes y día-de-la-semana), L (last: último día del mes, o último viernes con 5L), W (día laborable más cercano) y # (N-ésimo día de la semana del mes, por ejemplo 2#3 para el 3.er lunes). Una expresión Quartz no suele ser compatible con un crontab UNIX, y viceversa: es la principal fuente de error cuando se copia una expresión cron de una plataforma a otra.

# UNIX / Vixie cron (5 champs)
0 9 * * 1-5

# Quartz (6 champs avec secondes)
0 0 9 ? * MON-FRI

# Quartz (7 champs avec année)
0 0 9 ? * MON-FRI 2026

Leer 0 0 * * * es rápido. Leer */7 2-5 1,15 * 1-5 lo es claramente menos. Cuando una expresión se sale de lo trivial, el riesgo de error de interpretación aumenta y la cron decode se convierte en una etapa de revisión por derecho propio.

• Depuración en producción: entender por qué una tarea se disparó a las 03:17 y no a las 03:00, o identificar un solapamiento entre dos jobs.
• Code review: validar que un planificador enviado en pull request hace exactamente lo que el autor afirma, sin tener que memorizar la semántica de cada símbolo.
• Auditoría de planificadores: repasar los cron jobs de Linux en /etc/crontab y /etc/cron.d/, los triggers de Jenkins, los spec.schedule de Kubernetes CronJob, las reglas AWS EventBridge y los jobs GCP Cloud Scheduler.
• Migración legacy: retomar un /etc/crontab histórico sin documentación y reconstruir el mapa de tareas antes de un cambio de infraestructura.
• Onboarding: permitir que un nuevo desarrollador relea una crontab sin tener que aprender de la noche a la mañana todos los caracteres especiales.

El procedimiento para decodificar una expresión crontab con la herramienta:

1. Pegue su expresión cron en el campo de entrada (5 campos separados por espacios).
2. Indique el número de próximas ejecuciones que se deben calcular.
3. Haga clic en convert para lanzar la cron decode: la herramienta devuelve una frase humana que explica el disparo, además de la lista fechada de las próximas ejecuciones.
4. Compruebe visualmente que las fechas se corresponden con su intención (hora, día, frecuencia).
5. Copie la salida mediante el botón de copia para pegarla en un ticket, una PR o una documentación técnica.

La herramienta no se contenta con un parsing sintáctico: proporciona una explicación cron en lenguaje natural, lo que la convierte a la vez en cron decoder y en validador de planning.

Los patrones de a continuación cubren lo esencial de los cron schedules que aparecen en producción. Son todos válidos en Linux crontab, Kubernetes CronJob, GitHub Actions y en la mayoría de planificadores aplicativos.

Para ejecutar una tarea cron en un servidor Linux, se edita la crontab de usuario desde el shell:

# éditer la crontab de l'utilisateur courant
$ crontab -e

# lister les tâches existantes
$ crontab -l

# exemple de ligne ajoutée : sauvegarde quotidienne à 3h
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1

Ejemplo de salida del cron converter para */5 * * * *:

2026-05-05 00:00:00
2026-05-05 00:05:00
2026-05-05 00:10:00
2026-05-05 00:15:00
2026-05-05 00:20:00
...