Qué es una expresión cron
Cron es el programador de tareas clásico de Unix y Linux: un servicio que ejecuta comandos en horarios fijos, sin intervención humana. Cada tarea se describe con una expresión cron, una línea de cinco campos separados por espacios que indica cuándo debe ejecutarse. El mismo formato lo usan hoy muchos otros sistemas: GitHub Actions, Kubernetes, Jenkins, colas de trabajos y servicios en la nube.
La expresión 30 2 * * 1-5, por ejemplo, significa «a las 02:30 de lunes a viernes». Leer una expresión así requiere práctica y escribirla sin errores, más aún; por eso esta herramienta la traduce al español, le muestra cuándo se ejecutará y le avisa de los problemas habituales.
Cómo usar el generador
- Elija un tipo en el constructor guiado (cada N minutos, todos los días, una vez al mes…) y complete los datos: la expresión se escribe sola. También puede cargar uno de los ejemplos frecuentes.
- Si ya tiene una expresión, escríbala o péguela en el campo: la herramienta la valida y la explica. Al editarla a mano, el constructor pasa a «personalizada».
- Lea la descripción en español, la tabla con el significado de cada campo y los avisos, si los hay.
- Compruebe las próximas ejecuciones en la zona horaria que prefiera (hora local de su navegador o UTC) y copie el equivalente para su sistema: crontab, GitHub Actions, Kubernetes o Spring/Quartz.
Los cinco campos
| Posición | Campo | Valores | Notas |
|---|---|---|---|
| 1 | Minuto | 0–59 | |
| 2 | Hora | 0–23 | Formato de 24 horas. |
| 3 | Día del mes | 1–31 | No existe el día 31 en todos los meses. |
| 4 | Mes | 1–12 o JAN–DEC | Las abreviaturas están en inglés. |
| 5 | Día de la semana | 0–7 o SUN–SAT | 0 y 7 son domingo; 1 es lunes. |
Cada campo admite, además de un número, estos símbolos:
| Símbolo | Significado | Ejemplo | Se lee como |
|---|---|---|---|
* | Cualquier valor | * * * * * | cada minuto |
, | Lista de valores | 0 8,12,18 * * * | a las 08:00, 12:00 y 18:00 |
- | Rango | 0 9-17 * * * | cada hora de 09:00 a 17:00 |
/ | Paso | */15 * * * * | cada 15 minutos (0, 15, 30, 45) |
@daily… | Atajos | @hourly | equivale a 0 * * * * |
Los atajos disponibles son @yearly (o @annually), @monthly, @weekly, @daily (o @midnight) y @hourly. Existe también @reboot, que ejecuta la tarea una vez al arrancar el sistema y que, por no tener un horario, esta herramienta no puede proyectar.
Ejemplos de uso frecuente
Esta tabla se generó con el propio explicador, de modo que muestra exactamente lo que verá en la herramienta:
| Expresión | Se ejecuta |
|---|---|
* * * * * | Cada minuto |
*/5 * * * * | Cada 5 minutos |
0 * * * * | Al comienzo de cada hora |
0 */6 * * * | Cada 6 horas |
30 2 * * * | Todos los días a las 02:30 |
0 9 * * 1 | Los lunes a las 09:00 |
0 8 * * 1-5 | De lunes a viernes a las 08:00 |
*/15 9-17 * * 1-5 | Cada 15 minutos, entre las 09:00 y las 17:59, de lunes a viernes |
0 0 1 * * | El día 1 de cada mes a las 00:00 |
0 0 1 1 * | El 1 de enero a las 00:00 |
0 8,12,18 * * * | Todos los días a las 08:00, 12:00 y 18:00 |
0 0 * * 6,0 | Los sábados y domingos a las 00:00 |
0 0 1,15 * * | Los días 1 y 15 de cada mes a las 00:00 |
@daily | Todos los días a las 00:00 |
El error más común: el día del mes y el día de la semana
Cuando se restringen a la vez el día del mes y el día de la semana, cron no exige que se cumplan los dos: ejecuta la tarea cuando se cumple cualquiera de ellos. Por eso 0 0 13 * 5 no significa «los viernes 13», sino «el día 13 de cada mes y, además, todos los viernes». Para ejecutar una tarea solo los viernes 13 hay que programarla para todos los viernes y comprobar la fecha dentro del propio script.
| Expresión | Se ejecuta | Regla |
|---|---|---|
0 0 13 * 5 | El día 13 de cada mes o los viernes a las 00:00 | El día 13 de cada mes o los viernes (O) |
0 0 13 * * | El día 13 de cada mes a las 00:00 | Solo el día 13 de cada mes |
0 0 * * 5 | Los viernes a las 00:00 | Solo los viernes |
0 0 */2 * 1 | Los lunes que caigan en los días impares de cada mes a las 00:00 | Los lunes que además caigan en días impares (Y: el * del paso activa la regla Y) |
La regla tiene un matiz poco conocido: si alguno de los dos campos empieza por asterisco (incluidos pasos como */2), cron aplica la regla Y y exige ambos. Esta herramienta sigue el comportamiento de Vixie cron y de cronie, los más extendidos en Linux, y lo avisa cuando ocurre.
Zonas horarias y horario de verano
Cron interpreta la hora en la zona horaria del servidor donde se ejecuta, no en la suya. Esto causa dos problemas frecuentes:
- Desfase de horas. Una tarea programada «a las 08:00» en un servidor configurado en UTC se ejecuta a las 02:00 en Costa Rica (UTC−6). GitHub Actions usa siempre UTC; los CronJob de Kubernetes usan la zona del controlador salvo que se indique
timeZone(disponible de forma estable desde Kubernetes 1.27). - Horario de verano. En una zona con cambio de hora, una tarea programada entre la 01:00 y las 03:00 puede no ejecutarse el día en que se adelanta el reloj (esa hora no existe) o ejecutarse dos veces el día en que se atrasa (esa hora se repite). Para evitarlo, programe en UTC o fuera de esa franja.
Para comparar horas entre zonas, use el conversor de timestamp. El selector «Mostrar las ejecuciones en» le permite ver las próximas fechas en UTC o en la hora local de su navegador.
Variantes del formato en otros sistemas
| Sistema | Campos | Diferencias |
|---|---|---|
| Cron de Unix/Linux (crontab) | 5 | El formato que explica esta página. |
| Kubernetes (CronJob) | 5 | Igual que crontab; admite atajos como @daily y, desde la 1.27, el campo timeZone. |
| GitHub Actions | 5 | Siempre en UTC; solo se ejecuta en la rama predeterminada; intervalo mínimo de 5 minutos. Las ejecuciones pueden retrasarse en horas de mucha carga. |
Quartz y Spring (@Scheduled) | 6 o 7 | Añaden los segundos al principio (y, en Quartz, un año al final); exigen ? en el día del mes o de la semana; admiten L, W y #; numeran los días de la semana de 1 (domingo) a 7. |
| AWS EventBridge | 6 | Minutos, horas, día del mes, mes, día de la semana y año; exige ? en uno de los días; las reglas clásicas usan UTC. |
| Jenkins | 5 | Añade H (hash) para repartir la carga: H/15 * * * * se ejecuta cada 15 minutos con un desfase fijo por trabajo. |
| systemd (temporizadores) | — | Usa su propia sintaxis, OnCalendar=Mon..Fri 08:00, en lugar de cron. |
Esta herramienta genera el equivalente de Spring y Quartz cuando es posible; si la expresión restringe a la vez el día del mes y el de la semana, esos sistemas no pueden representarla.
Buenas prácticas para tareas programadas
- Use rutas absolutas y no confíe en el
PATHni en las variables de entorno de su sesión: cron las ejecuta con un entorno mínimo. - Guarde la salida (
>> /var/log/tarea.log 2>&1); si no, cron la envía por correo local o la descarta. - Escape el signo % en la línea de crontab (
\%): sin escapar se interpreta como un salto de línea y rompe comandos comodate +%Y-%m-%d. - Evite que se solapen las ejecuciones cuando una tarea puede durar más que su intervalo, con un bloqueo (
flock) o el campoconcurrencyPolicyde Kubernetes. - Haga las tareas idempotentes: que ejecutar dos veces seguidas o recuperar una ejecución perdida no cause daños.
- Vigile que se ejecutan. Un cron que deja de funcionar no avisa; use un servicio de monitoreo que espere una señal periódica.
- Reparta las horas en puntos. Si muchos servidores ejecutan algo a las 00:00, se concentra la carga; desfase unos minutos cada uno.
Preguntas frecuentes
¿Cuántos campos tiene una expresión cron?
La estándar de Unix y Linux tiene 5: minuto, hora, día del mes, mes y día de la semana. Quartz y Spring añaden los segundos al principio (6 campos) y Quartz admite además un año al final (7).
¿Qué significa */5 en cron?
Un paso: «cada 5 unidades del campo, empezando por el principio de su rango». En los minutos, */5 equivale a 0, 5, 10… 55. Tenga en cuenta que si el paso no divide al rango (por ejemplo */7 en los minutos), el intervalo no es uniforme: tras el minuto 56 la tarea vuelve a ejecutarse en el 0, solo 4 minutos después.
¿Por qué mi tarea se ejecuta a una hora distinta de la que programé?
Porque cron usa la zona horaria del servidor, que a menudo es UTC. Compruebe la zona del servidor o programe pensando en ella. GitHub Actions usa siempre UTC, y en Kubernetes puede indicar la zona con el campo timeZone.
¿Qué pasa si indico día del mes y día de la semana a la vez?
Se ejecuta cuando se cumple cualquiera de los dos (O), no ambos. Así, «0 0 13 * 5» se ejecuta el día 13 de cada mes y todos los viernes. Si uno de los campos empieza por asterisco, la regla pasa a ser Y.
¿Puedo programar una tarea cada pocos segundos con cron?
No: la resolución mínima de cron es de un minuto. Para intervalos menores se usan bucles con pausa dentro de un servicio, temporizadores de systemd o programadores como Quartz, que admiten segundos.
¿Cómo programo «el último día del mes»?
En el cron estándar no existe esa opción (L es de Quartz). Una solución habitual es ejecutar la tarea todos los días y comprobar en el script si mañana es día 1, por ejemplo con «[ "$(date -d tomorrow +%d)" = "01" ]» en Linux.
¿Se envía mi expresión a algún servidor?
No. La herramienta se ejecuta en su navegador: la explicación y el cálculo de las próximas fechas se hacen en su equipo.