Guía rápida de expresiones cron con ejemplos reales
La sintaxis de cron en una página: los cinco campos, los cuatro operadores, horarios listos para copiar y las trampas del OR entre días, el DST y las variantes.
Actualizado
Una expresión cron son cinco campos separados por espacios: minuto, hora, día del mes, mes y día de la semana. 0 9 * * 1-5 significa a las 09:00 de lunes a viernes. * significa todos los valores, , enumera valores, - define un rango y / establece un paso. Eso es casi toda la sintaxis; el resto de esta página son ejemplos y trampas.
Los cinco campos
En orden, con sus rangos permitidos:
- Minuto:
0-59 - Hora:
0-23(reloj de 24 horas) - Día del mes:
1-31 - Mes:
1-12oJAN-DEC - Día de la semana:
0-6, donde0es domingo (7también significa domingo en la mayoría de los sistemas), oSUN-SAT
La expresión se dispara cuando la hora actual coincide con todos los campos, con una excepción que se explica más abajo. Las horas se evalúan en la zona horaria de la máquina o del servicio que ejecuta el planificador, que suele ser UTC en servidores y contenedores.
Operadores
*cualquier valor.* * * * *es cada minuto.,lista.0 9,17 * * *es a las 09:00 y a las 17:00.-rango.0 9-17 * * *es al inicio de cada hora desde las 09:00 hasta las 17:00, nueve ejecuciones./paso.*/15 * * * *es cada 15 minutos::00,:15,:30,:45.0 */6 * * *es cada seis horas. Los pasos pueden empezar con un desplazamiento:5/15en el campo de los minutos significa:05,:20,:35,:50.
Los operadores se combinan: 0 8-18/2 * * 1-5 es cada dos horas de 08:00 a 18:00 de lunes a viernes.
Ejemplos reales
* * * * *cada minuto*/5 * * * *cada 5 minutos0 * * * *cada hora, en punto30 * * * *cada hora a las :300 0 * * *a diario a medianoche0 3 * * *a diario a las 03:00, el horario clásico de las copias de seguridad0 9 * * 1-5de lunes a viernes a las 09:000 0 * * 0semanal, el domingo a medianoche0 0 * * 1semanal, el lunes a medianoche0 0 1 * *el primer día de cada mes a medianoche0 0 1 1 *una vez al año, el 1 de enero0 0 1 */3 *trimestral: 1 de enero, 1 de abril, 1 de julio, 1 de octubre0 9,13,17 * * *tres veces al día0 22 * * 1-5las noches de lunes a viernes a las 22:000 0 * * 6,0sábado y domingo a medianoche15 2 * * *a las 02:15 a diario, desplazado respecto a la hora en punto0 0 */2 * *un día sí y otro no, más o menos; el paso se reinicia el día 1, así que un mes de 31 días termina con ejecuciones en días consecutivos
Escribir una de estas a mano es fácil. Comprobar que hace lo que querías es donde ayuda el generador de expresiones cron: convierte cualquier expresión en una frase en lenguaje natural y lista las próximas cinco ejecuciones.
Las trampas
El día del mes y el día de la semana son OR, no AND
Es la regla más sorprendente de cron. Si los dos campos de día están restringidos, la tarea se ejecuta cuando coincide cualquiera de ellos. 0 0 13 * 5 se ejecuta el día 13 de cada mes y todos los viernes, no solo el viernes 13. No hay sintaxis de cron estándar para "el 13 solo si es viernes"; haz esa comprobación dentro del script.
El último día del mes
El cron estándar no tiene L. 0 0 28-31 * * se dispara hasta cuatro veces. La solución habitual es ejecutar la tarea a diario y dejar que el script compruebe si date -d tomorrow +%d es igual a 01. Quartz (Java) y algunos planificadores en la nube amplían la sintaxis con L, W y #, pero esas expresiones no funcionan en un crontab de Linux.
El horario de verano
Una tarea en 0 2 * * * en una zona horaria con horario de verano (DST) se omitirá la noche en que el reloj se adelanta y se ejecutará dos veces la noche en que se atrasa. Programa los servidores en UTC o elige horas que nunca caigan en la ventana del cambio.
Variantes no estándar
- El crontab de Linux acepta
@hourly,@daily,@weekly,@monthly,@yearlyy@reboot. - Quartz, Spring y algunos servicios de AWS usan seis o siete campos, con los segundos al principio y un año opcional al final.
0 0 9 * * ?es la forma de Quartz de decir a diario a las 09:00; el?significa "ningún valor concreto" y es obligatorio en uno de los dos campos de día. - GitHub Actions y los CronJobs de Kubernetes usan los cinco campos estándar en UTC. GitHub también documenta que el intervalo mínimo permitido es de cinco minutos y que las tareas pueden empezar con retraso en momentos de mucha carga.
Cron no tiene memoria. Si la máquina está apagada o el contenedor no está en marcha en el minuto programado, esa ejecución simplemente se pierde. Usa una cola de tareas o un planificador que recupere las ejecuciones perdidas si cada ejecución importa.
Comprobar tu programación
La lista de próximas ejecuciones es la verificación más rápida. Si las cinco primeras horas no son las que imaginabas, la expresión está mal. Si la tarea escribe marcas de tiempo en logs o en una base de datos, convierte los valores epoch registrados con el conversor de timestamps Unix y compáralos con la programación prevista; un desfase de una hora después de un cambio de horario de verano es un hallazgo frecuente.
Para medir cuánto tiempo pasó de verdad entre dos ejecuciones, la calculadora de duración da el intervalo exacto en días, horas y minutos entre dos marcas de tiempo.
Hay más utilidades de programación y formato en la categoría para desarrolladores.
Pruébalo
Escribe o construye una expresión en el generador de expresiones cron, lee el resumen en lenguaje natural y confirma las próximas cinco ejecuciones antes de que llegue a un crontab, un flujo de CI o un manifiesto de CronJob.